VNDocumentCameraViewController首次扫描后如何禁用自动快门

VNDocumentCameraViewController 是苹果VisionKit框架提供的原生文档扫描控件，苹果没有开放公开API用于直接控制自动快门默认状态，也没有提供首次扫描完成的官方回调来触发快门状态切换，所有快门相关逻辑都封装在控件内部。

实现「首次扫描自动开启快门、拍完首张后自动关闭快门」 #

可以通过视图层级遍历找到自动快门的切换按钮，在检测到首次扫描完成时模拟按钮点击实现状态切换，该方案不涉及私有API调用，过审风险较低：

1. 首先在持有扫描控制器的类中添加标记变量，用来记录是否已经完成首次扫描

var hasFinishedFirstScan = false

2. 弹出扫描控制器前重置标记状态

hasFinishedFirstScan = false
let documentCameraViewController = VNDocumentCameraViewController() 
documentCameraViewController.delegate = self
present(documentCameraViewController, animated: true)

3. 实现VNDocumentCameraViewControllerDelegate的扫描结果回调，检测到首张扫描完成时，遍历视图找到快门按钮触发关闭

func documentCameraViewController(_ controller: VNDocumentCameraViewController, didFinishWith scan: VNDocumentCameraScan) {
    guard !hasFinishedFirstScan, scan.pageCount >= 1 else { return }
    hasFinishedFirstScan = true
    
    // 递归遍历控制器视图层级查找自动快门按钮
    func findAutoShutterButton(in view: UIView) -> UIButton? {
        for subview in view.subviews {
            if let button = subview as? UIButton,
               // 匹配自动快门按钮的图标特征，不同系统版本可根据实际打印结果调整规则
               button.image(for: .normal)?.description.contains("AutoShutter") == true {
                return button
            }
            if let targetButton = findAutoShutterButton(in: subview) {
                return targetButton
            }
        }
        return nil
    }
    
    // 模拟点击关闭自动快门
    if let shutterButton = findAutoShutterButton(in: controller.view) {
        shutterButton.sendActions(for: .touchUpInside)
    }
}

注意：不同iOS版本的VisionKit内部视图层级、按钮属性可能存在差异，如果找不到按钮，可以在遍历时打印所有子视图的类名、accessibility属性，调整匹配规则即可，上线前需要覆盖所有适配的系统版本做测试。

设置自动快门默认关闭 #

如果上述方案在适配版本上稳定性不符合预期，可以通过同样的视图遍历方式，在扫描控制器弹出后直接将自动快门切换为关闭状态：

let documentCameraViewController = VNDocumentCameraViewController() 
documentCameraViewController.delegate = self
present(documentCameraViewController, animated: true) {
    func findAutoShutterButton(in view: UIView) -> UIButton? {
        for subview in view.subviews {
            if let button = subview as? UIButton,
               button.image(for: .normal)?.description.contains("AutoShutter") == true {
                return button
            }
            if let targetButton = findAutoShutterButton(in: subview) {
                return targetButton
            }
        }
        return nil
    }
    // 延迟0.3秒确保控制器视图完全加载
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
        guard let shutterButton = findAutoShutterButton(in: documentCameraViewController.view),
              shutterButton.isSelected == false else { return }
        shutterButton.sendActions(for: .touchUpInside)
    }
}

补充说明 #

以上两种方案均依赖原生控件的内部视图结构，若后续iOS系统更新修改了VNDocumentCameraViewController的内部布局，可能导致功能失效，需要随系统版本迭代同步适配。
如果业务对扫描功能的自定义程度、稳定性要求极高，建议放弃使用系统封装好的VNDocumentCameraViewController，基于AVFoundation自定义相机，配合Vision框架的文档识别能力实现扫描流程，即可完全控制快门逻辑、UI样式等所有交互。

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