iOS相机因videoDeviceNotAvailableWithMultipleForegroundApps错误导致黑屏的处理方案及会话管理最佳实践咨询

阿华AIGC实验室

2026-4-7

看起来你已经精准定位到了这个小众但棘手的相机错误，用户看着黑屏一脸懵的场景确实闹心——尤其是重试还不管用的情况下。我来结合iOS相机开发的最佳实践，给你梳理下可行的处理思路：

一、先明确：这个错误能预防吗？

很遗憾，预防基本不可行。这个错误本质是系统级的相机资源调度限制：当系统检测到有多个前台应用（包括iPad的分屏/侧拉、iPhone上某些特殊多任务场景，比如画中画+前台应用、系统服务临时占用等）请求相机时，会直接禁止当前APP的访问权限。

你提到的com.apple.developer.avfoundation.multitasking-camera-access entitlement确实已被苹果废弃，现在没有官方权限能绕过这个系统限制。所以我们的核心要放在优雅的错误告知和用户引导恢复上，而不是强行自动重试（这也是为什么你的重试系统没用——只要系统限制还在，重试只会重复失败）。

二、针对`videoDeviceNotAvailableWithMultipleForegroundApps`的具体处理方案

1. 替换黑屏为直观的占位UI

绝对不能让用户看空白屏幕！在相机预览区域显示一个友好的提示界面：比如带相机图标的占位图+通俗的文字说明（比如“相机被其他应用占用啦，请关闭后重试”），让用户明确知道不是APP崩溃了。

2. 弹出清晰的用户提示

用UIAlertController弹出明确的提示，避免技术术语，直接说用户能听懂的话，同时提供手动重试入口（让用户主动触发，而不是自动循环重试）。

3. 监听系统状态，自动尝试恢复

监听UIApplication.didBecomeActiveNotification，当APP从后台回到前台时，自动尝试一次相机会话重启——这时候用户可能已经关闭了占用相机的其他应用。

代码示例（修改你的中断处理逻辑）

@objc private func sessionWasInterrupted(notification: Notification) {
    guard let reasonValue = notification.userInfo?[AVCaptureSessionInterruptionReasonKey] as? Int,
          let reason = AVCaptureSession.InterruptionReason(rawValue: reasonValue) else {
        return
    }
    
    let reasonString: String
    switch reason {
    case .videoDeviceNotAvailableInBackground:
        reasonString = "videoDeviceNotAvailableInBackground"
    case .audioDeviceInUseByAnotherClient:
        reasonString = "audioDeviceInUseByAnotherClient"
    case .videoDeviceInUseByAnotherClient:
        reasonString = "videoDeviceInUseByAnotherClient"
    case .videoDeviceNotAvailableWithMultipleForegroundApps:
        reasonString = "videoDeviceNotAvailableWithMultipleForegroundApps"
        // 触发错误处理UI
        DispatchQueue.main.async { [weak self] in
            self?.showCameraOccupiedAlert()
            self?.showCameraPlaceholderUI()
        }
    case .videoDeviceNotAvailableDueToSystemPressure:
        reasonString = "videoDeviceNotAvailableDueToSystemPressure"
        // 系统压力场景可以延迟自动重试
        DispatchQueue.main.asyncAfter(deadline: .now() + 2) { [weak self] _ in
            self?.attemptToRestartCameraSession()
        }
    @unknown default:
        reasonString = "unknown(\(reason.rawValue))"
    }
    
    print("Camera session interrupted: \(reasonString)")
}

// 显示用户提示框
private func showCameraOccupiedAlert() {
    let alert = UIAlertController(
        title: "相机无法使用",
        message: "有其他应用在前台占用相机资源，请关闭后重试",
        preferredStyle: .alert
    )
    alert.addAction(UIAlertAction(title: "我知道了", style: .default))
    alert.addAction(UIAlertAction(title: "重试", style: .default) { [weak self] _ in
        self?.attemptToRestartCameraSession()
    })
    present(alert, animated: true)
}

// 显示占位UI替代黑屏
private func showCameraPlaceholderUI() {
    previewView.isHidden = true
    cameraPlaceholderView.isHidden = false
    cameraPlaceholderLabel.text = "相机被占用，请关闭其他使用相机的应用后重试"
}

// 重新启动相机会话的方法
private func attemptToRestartCameraSession() {
    DispatchQueue.global(qos: .userInitiated).async { [weak self] in
        guard let self = self else { return }
        
        // 先停止当前会话（如果还在运行）
        if self.cameraCaptureSession.isRunning {
            self.cameraCaptureSession.stopRunning()
            // 可选：清理会话输入输出，避免资源泄漏
            self.cameraCaptureSession.inputs.forEach { self.cameraCaptureSession.removeInput($0) }
            self.cameraCaptureSession.outputs.forEach { self.cameraCaptureSession.removeOutput($0) }
        }
        
        do {
            // 重新配置相机会话（和你初始化时的配置逻辑一致）
            try self.configureCameraSession()
            self.cameraCaptureSession.startRunning()
            
            // 启动成功，切换回预览UI
            DispatchQueue.main.async {
                self.previewView.isHidden = false
                self.cameraPlaceholderView.isHidden = true
            }
        } catch {
            print("重启相机失败：\(error.localizedDescription)")
            DispatchQueue.main.async {
                self.showCameraOccupiedAlert()
            }
        }
    }
}

三、相机会话管理的关键最佳实践

1. 严格跟随APP生命周期管理会话

进入后台时：不仅要调用cameraCaptureSession.stopRunning()，还要移除会话的所有输入输出，释放AVCaptureDeviceInput等资源——系统会在后台强制收回相机权限，残留的会话资源可能导致再次激活时无法重新获取相机。
回到前台时：不要直接重启旧会话，而是重新配置会话（重新添加输入输出）再启动，确保会话状态是干净的。

2. 避免自动无限重试

像videoDeviceNotAvailableWithMultipleForegroundApps这种错误，自动重试完全是浪费资源——因为系统限制没解除的话，重试100次也会失败。把重试的控制权交给用户，或者只在APP激活时尝试一次。

3. 监听中断结束通知

除了中断通知，还要监听AVCaptureSessionInterruptionEndedNotification，当系统解除相机限制时（比如用户关闭了其他应用），自动尝试重启会话：

NotificationCenter.default.addObserver(
    self,
    selector: #selector(sessionInterruptionEnded),
    name: .AVCaptureSessionInterruptionEnded,
    object: cameraCaptureSession
)

@objc private func sessionInterruptionEnded() {
    attemptToRestartCameraSession()
}