iPad端相机应用保存图像出现左右黑边，如何排查代码问题？

嘿，我来帮你定位这个iPad上的黑边问题！从你提供的代码和描述来看，问题大概率出在相机会话的配置或者图像后期处理的尺寸适配上，下面是具体的排查和修复方向：

1. 检查AVCaptureSession的会话预设（sessionPreset） #

你当前的代码里没展示会话配置，但这是最常见的触发原因。如果你的AVCaptureSession用了固定比例的预设（比如AVCaptureSessionPreset1920x1080这类16:9的），而iPad的相机传感器原生比例是4:3，就会导致拍摄的图像被强制缩放适配，进而出现黑边。

• 建议优先使用自适应的预设，比如AVCaptureSessionPresetPhoto，它会匹配设备相机的原生分辨率和比例，避免强制裁剪或拉伸。
• 如果需要特定分辨率，要确保预设的比例和iPad屏幕/相机传感器的比例一致，比如iPad常用4:3，对应AVCaptureSessionPreset3264x2448这类预设。

2. 修正AVCaptureConnection的videoGravity和方向设置 #

在你获取videoConnection的代码段里，要确保设置了正确的videoGravity和屏幕方向，不然相机预览和拍摄的图像会出现比例不匹配：

if let videoConnection = stillImageOutput.connection(with: .video) {
    // 设置视频重力模式为填充（避免黑边）
    videoConnection.videoGravity = .resizeAspectFill
    // 匹配当前设备的屏幕方向
    if let currentOrientation = UIApplication.shared.windows.first?.windowScene?.interfaceOrientation {
        videoConnection.videoOrientation = AVCaptureVideoOrientation(rawValue: currentOrientation.rawValue) ?? .portrait
    }
    // 然后执行拍摄逻辑...
}

这里的.resizeAspectFill会让图像填满预览区域，而.resizeAspect会保持比例但可能留黑边，你可以根据需求调整。

3. 排查drawCirclesOnImage方法的尺寸处理 #

你调用了drawCirclesOnImage(fromImage: cameraImage, targetSize: CGSize.zero)，这里传CGSize.zero可能会导致方法内部使用默认的固定尺寸，没有适配iPad的屏幕比例。

• 打开这个方法的实现，检查它是如何处理目标尺寸的：
  • 如果是基于固定宽高比生成图像，要确保这个比例和iPad的相机输出比例一致；
  • 如果是根据输入图像尺寸处理，要保证没有强制裁剪或添加额外的黑边；
  • 建议直接传入cameraImage.size作为targetSize，或者基于当前设备的屏幕尺寸动态计算合适的大小。

4. 验证UIImage的方向和缩放因子 #

你创建cameraImage时用了UIScreen.main.scale，这在iPad上通常没问题，但要注意图像的imageOrientation是否正确。有时候相机拍摄的图像方向和屏幕方向不匹配，会导致保存后显示比例异常。

可以在保存前打印图像的尺寸和方向来排查：

print("相机图像尺寸: \(cameraImage.size), 方向: \(cameraImage.imageOrientation.rawValue)")

如果方向不对，可以用UIImage的fixedOrientation()扩展方法（需要自行实现）来修正方向，确保图像的实际像素比例正确。

最后再测试一下 #

按照上面的步骤调整后，重新在iPad上测试保存功能，应该就能解决左右黑边的问题了。本质上就是要让相机输出的图像比例、后期处理的图像比例和设备的屏幕/相册显示比例保持一致，避免强制适配带来的黑边。

内容的提问来源于stack exchange，提问作者Harry McGovern