iOS使用VisionKit开发扫描App提示文档摄像头不可用如何解决

1. 模拟器运行是直接报错的核心原因 #

VNDocumentCameraViewController 是VisionKit提供的文档扫描专用控制器，完全依赖iOS设备的真实摄像头硬件能力，苹果官方明确禁止该类在模拟器上运行，模拟器没有对应硬件支持，必然触发线程崩溃类报错。你首先需要将项目切换到搭载真实摄像头的iOS真机上运行测试。

2. 现有代码的权限逻辑缺陷 #

即使切换到真机，你当前的代码没有提前做摄像头权限校验，直接唤起扫描控制器也可能触发报错，需要补充权限判断逻辑：

第一步：引入AVFoundation框架 #

在ViewController的头部引入权限检测所需的依赖：

import AVFoundation

第二步：修改相机唤起逻辑，增加权限校验 #

替换原有的configureDocumentView调用逻辑，修改后的完整代码如下：

@IBAction func openCameraButtonTaped(_ sender: Any) {
    checkCameraPermission { [weak self] isGranted in
        guard isGranted else {
            // 权限被拒绝的情况可以在这里弹提示引导用户去系统设置开启权限
            return
        }
        self?.configureDocumentView()
    }
}

// 新增摄像头权限检测方法
private func checkCameraPermission(completion: @escaping (Bool) -> Void) {
    switch AVCaptureDevice.authorizationStatus(for: .video) {
    case .notDetermined:
        AVCaptureDevice.requestAccess(for: .video) { granted in
            DispatchQueue.main.async {
                completion(granted)
            }
        }
    case .authorized:
        DispatchQueue.main.async {
            completion(true)
        }
    case .denied, .restricted:
        DispatchQueue.main.async {
            completion(false)
        }
    @unknown default:
        DispatchQueue.main.async {
            completion(false)
        }
    }
}

private func configureDocumentView() {
    let scannerViewController = VNDocumentCameraViewController()
    scannerViewController.delegate = self
    self.present(scannerViewController, animated: true, completion: nil)
}

3. 现有配置校验 #

你当前info.plist中已经添加的NSCameraUsageDescription权限声明配置是正确的，不需要额外修改。

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