Swift iOS应用中AVFoundation的Central Stage模式在Photo预设下失效

问题描述 #

开发iPad前置摄像头应用时，基于AVFoundation框架实现相机逻辑，使用Central Stage模式实现人脸居中，但该模式仅在设置captureSession.sessionPreset = .photo时失效，其余所有预设（包括high、medium、low、cif352x288、vga640x480、hd1280x720、hd1920x1080、iFrame960x540、iFrame1280x720、inputPriority）均能正常工作。已联系苹果开发者支持未获回复，怀疑是未公开的Bug。

代码示例 #

func setupCamera() {
    guard let videoCaptureDevice = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .front) else { return }
    AVCaptureDevice.centerStageControlMode = .app
    AVCaptureDevice.isCenterStageEnabled = true
    
    do {
        let input = try AVCaptureDeviceInput(device: videoCaptureDevice)
        captureSession.addInput(input)
        captureSession.addOutput(photoOutput)
        captureSession.sessionPreset = .photo
        
        DispatchQueue.global(qos: .userInteractive).async {
            self.captureSession.startRunning()
        }
        
    } catch {
        print("Error setting up camera: \(error.localizedDescription)")
    }
}

分析与解决方案 #

可能原因 #

.photo预设是针对静态照片捕获优化的配置，会优先启用摄像头的最高分辨率静态图像模式，这可能与Central Stage依赖的实时视频流分析、取景调整逻辑存在兼容性冲突——该预设下的会话配置可能限制了视频流的实时处理能力，导致Central Stage无法正常工作。

替代方案 #

1. 使用high预设替代.photo
high预设可提供高质量的视频与照片输出，且不会影响Central Stage功能。若需保证静态照片质量，可额外配置AVCapturePhotoOutput优化捕获设置：

// 配置照片输出的高质量参数
let photoSettings = AVCapturePhotoSettings()
photoSettings.isHighResolutionPhotoEnabled = true
if let previewFormat = photoSettings.availablePreviewPhotoPixelFormatTypes.first {
    photoSettings.previewPhotoFormat = [kCVPixelBufferPixelFormatTypeKey as String: previewFormat]
}
// 捕获照片时使用该配置
photoOutput.capturePhoto(with: photoSettings, delegate: self)

2. 调整会话配置顺序
   尝试先设置sessionPreset，再添加输入输出设备，避免预设配置被后续操作覆盖：

func setupCamera() {
    guard let videoCaptureDevice = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .front) else { return }
    AVCaptureDevice.centerStageControlMode = .app
    AVCaptureDevice.isCenterStageEnabled = true
    
    do {
        // 优先设置会话预设
        captureSession.sessionPreset = .photo
        let input = try AVCaptureDeviceInput(device: videoCaptureDevice)
        captureSession.addInput(input)
        captureSession.addOutput(photoOutput)
        
        DispatchQueue.global(qos: .userInteractive).async {
            self.captureSession.startRunning()
        }
        
    } catch {
        print("Error setting up camera: \(error.localizedDescription)")
    }
}

3. 多设备兼容性测试
   部分旧款iPad可能存在硬件级的兼容性问题，建议在不同型号的iPad上测试，确认问题是否仅出现在特定设备上。

内容的提问来源于stack exchange，提问作者Егор Нечвола