请求重构iOS相机代码：AVCapturePhotoOutput无指定方法

嘿，这个坑我之前也踩过！你遇到的是AVFoundation框架API版本更新的问题——captureStillImageAsynchronously(from:completionHandler:)是旧版AVCaptureStillImageOutput类的专属方法，而你现在使用的是AVCapturePhotoOutput（苹果推荐的新版拍照输出类），两者API完全不兼容，自然会报错。

下面是完整的重构步骤和代码示例，帮你替换掉旧的调用逻辑：

1. 先明确核心差异 #

• 旧版AVCaptureStillImageOutput通过sampleBuffer直接返回图片数据，调用同步/异步方法就能获取结果
• 新版AVCapturePhotoOutput采用代理模式，通过AVCapturePhotoCaptureDelegate协议回调返回AVCapturePhoto对象，需要先配置拍照参数再触发捕获

2. 重构代码的具体步骤 #

第一步：让你的相机类遵守代理协议 #

首先，确保管理相机的类（比如ViewController或自定义CameraManager）遵守AVCapturePhotoCaptureDelegate协议：

class YourCameraManager: NSObject, AVCapturePhotoCaptureDelegate {
    // 相机核心属性
    private let captureSession = AVCaptureSession()
    private let photoOutput = AVCapturePhotoOutput()
    // ... 其他属性（比如预览图层、摄像头输入等）
}

第二步：配置捕获会话（确保已添加photoOutput） #

在相机初始化/配置方法中，把photoOutput添加到捕获会话：

func setupCameraSession() {
    captureSession.sessionPreset = .photo // 设置照片质量
    
    // 添加后置摄像头输入（可根据需求切换为前置）
    guard let cameraDevice = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back),
          let input = try? AVCaptureDeviceInput(device: cameraDevice),
          captureSession.canAddInput(input) else {
        print("无法配置相机输入")
        return
    }
    captureSession.addInput(input)
    
    // 将photoOutput加入会话
    if captureSession.canAddOutput(photoOutput) {
        captureSession.addOutput(photoOutput)
    }
    
    // 启动捕获会话
    captureSession.startRunning()
}

第三步：替换旧的捕获方法为新版调用 #

把原来调用captureStillImageAsynchronously的代码，替换成AVCapturePhotoOutput的capturePhoto(with:delegate:)方法：

// 触发拍照的方法
func takeStillPhoto() {
    // 获取视频连接（确保相机处于活跃状态）
    guard let videoConnection = photoOutput.connection(with: .video) else {
        print("无法获取视频连接，可能相机未启动")
        return
    }
    
    // 创建拍照配置（可自定义参数：格式、闪光灯、分辨率等）
    let photoSettings = AVCapturePhotoSettings()
    // 配置预览图格式（可选）
    if let previewPixelFormat = photoSettings.availablePreviewPhotoPixelFormatTypes.first {
        photoSettings.previewPhotoFormat = [
            kCVPixelBufferPixelFormatTypeKey as String: previewPixelFormat,
            kCVPixelBufferWidthKey as String: 640,
            kCVPixelBufferHeightKey as String: 480
        ]
    }
    // 设置闪光灯模式（可选）
    photoSettings.flashMode = .auto
    
    // 触发拍照，当前类作为代理接收结果
    photoOutput.capturePhoto(with: photoSettings, delegate: self)
}

第四步：实现代理方法处理拍照结果 #

通过AVCapturePhotoCaptureDelegate的回调方法获取拍照结果，替代原来的completionHandler逻辑：

func photoOutput(_ output: AVCapturePhotoOutput, didFinishProcessingPhoto photo: AVCapturePhoto, error: Error?) {
    // 先处理错误情况
    if let error = error {
        print("拍照失败：\(error.localizedDescription)")
        return
    }
    
    // 从AVCapturePhoto对象中提取图片数据
    guard let imageData = photo.fileDataRepresentation() else {
        print("无法获取图片数据")
        return
    }
    
    // 转换为UIImage（根据需求处理：显示、保存等）
    if let capturedImage = UIImage(data: imageData) {
        print("成功捕获图片！")
        // 示例：将图片显示到UI
        // DispatchQueue.main.async {
        //     self.imageView.image = capturedImage
        // }
    }
}

3. 额外注意事项 #

• 务必在Info.plist中添加NSCameraUsageDescription键并填写权限说明，确保已获取相机权限
• 如果需要切换前后摄像头，要重新获取对应AVCaptureDevice并更新会话输入
• AVCapturePhoto支持获取RAW格式图片、深度数据等，可根据业务需求扩展配置

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