Swift中AVCaptureSession条码扫描无响应问题排查求助

我帮你梳理了代码里的几个关键遗漏点，这些应该就是导致条码无法识别的核心原因：

1. 未实现核心代理方法 #

你已经声明遵守AVCaptureMetadataOutputObjectsDelegate协议，但没有实现关键的回调方法——metadataOutput(_:didOutput:from:)。这个方法是系统用来通知你捕获到条码元数据的唯一入口，没有它，即使会话捕获到条码，你的代码也无法感知和处理。

添加以下代理方法实现：

func metadataOutput(_ output: AVCaptureMetadataOutput, didOutput metadataObjects: [AVMetadataObject], from connection: AVCaptureConnection) {
    // 检查是否有有效识别结果
    guard !metadataObjects.isEmpty else {
        qrCodeFrameView?.frame = CGRect.zero
        return
    }

    // 获取第一个识别到的条码对象（通常是最清晰的目标）
    guard let metadataObj = metadataObjects.first as? AVMetadataMachineReadableCodeObject else { return }
    
    // 验证是否在支持的条码类型范围内
    if supportedCodeTypes.contains(metadataObj.type) {
        // 将条码坐标转换为预览层的坐标系
        if let barCodeObject = videoPreviewLayer?.transformedMetadataObject(for: metadataObj) {
            qrCodeFrameView?.frame = barCodeObject.frame
        }
        
        // 获取条码内容并处理
        if let codeValue = metadataObj.stringValue {
            print("识别到条码内容：\(codeValue)")
            // 这里可以添加你的业务逻辑，比如停止扫描、跳转页面等
            captureSession?.stopRunning()
        }
    }
}

2. 缺少相机权限请求（iOS 10+ 必需） #

你的代码没有请求相机权限，虽然相机会话可能能启动，但在iOS 10及以上系统中，未授权的情况下可能无法正常捕获元数据。建议在viewDidLoad开头添加权限请求逻辑：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 先请求相机权限
    AVCaptureDevice.requestAccess(for: .video) { [weak self] granted in
        DispatchQueue.main.async {
            guard let self = self else { return }
            if granted {
                // 权限通过后再初始化捕获会话
                self.setupCaptureSession()
            } else {
                // 提示用户开启权限
                let alert = UIAlertController(title: "需要相机权限", message: "请在设置中开启相机权限以使用扫描功能", preferredStyle: .alert)
                alert.addAction(UIAlertAction(title: "前往设置", style: .default, handler: { _ in
                    UIApplication.shared.open(URL(string: UIApplication.openSettingsURLString)!)
                }))
                alert.addAction(UIAlertAction(title: "取消", style: .cancel))
                self.present(alert, animated: true)
            }
        }
    }
}

// 把原来的会话初始化逻辑抽成单独方法
private func setupCaptureSession() {
    let captureDevice = AVCaptureDevice.default(for: AVMediaType.video)
    do {
        let input = try AVCaptureDeviceInput(device: captureDevice!)
        captureSession = AVCaptureSession()
        captureSession?.addInput(input)
        
        let captureMetadataOutput = AVCaptureMetadataOutput()
        captureSession?.addOutput(captureMetadataOutput)
        
        captureMetadataOutput.setMetadataObjectsDelegate(self, queue: DispatchQueue.main)
        captureMetadataOutput.metadataObjectTypes = supportedCodeTypes
        
        videoPreviewLayer = AVCaptureVideoPreviewLayer(session: captureSession!)
        videoPreviewLayer?.videoGravity = AVLayerVideoGravity.resizeAspectFill
        videoPreviewLayer?.frame = view.layer.bounds
        view.layer.addSublayer(videoPreviewLayer!)
        
        captureSession?.startRunning()
        
        // 初始化高亮框
        qrCodeFrameView = UIView()
        if let qrCodeFrameView = qrCodeFrameView {
            qrCodeFrameView.layer.borderColor = UIColor.green.cgColor
            qrCodeFrameView.layer.borderWidth = 2
            view.addSubview(qrCodeFrameView)
            view.bringSubview(toFront: qrCodeFrameView)
        }
    } catch {
        print("捕获会话初始化失败：\(error)")
        return
    }
}

3. 支持的条码类型不够全面 #

你当前的supportedCodeTypes只包含了3种条码类型，如果用户扫描的是其他常见类型（比如Code128、EAN13等），就会无法识别。建议扩展支持的类型：

let supportedCodeTypes: [AVMetadataObject.ObjectType] = [
    .upce,
    .code39,
    .code39Mod43,
    .code93,
    .code128,
    .ean8,
    .ean13,
    .aztec,
    .pdf417,
    .qr
]

完成以上修复后，你的条码扫描器应该就能正常识别条码了。

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