AVFoundation无法识别低对比度二维码，该如何解决？

我之前也碰到过类似的低对比度二维码扫描问题，AVFoundation默认配置确实对这类边缘场景不太友好，不过咱们可以从调整原生配置、改用第三方工具这两个方向来解决：

调整AVCaptureSession适配低对比度二维码 #

AVFoundation不是不能扫这类二维码，只是默认参数偏向通用场景，咱们可以针对性调整：

• 优化设备曝光与白平衡：手动开启连续自动曝光和白平衡，让设备自动适配画面亮度，提升二维码与背景的对比度。代码示例：

if let device = AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back) {
    do {
        try device.lockForConfiguration()
        // 开启连续自动曝光
        device.exposureMode = .continuousAutoExposure
        // 开启连续自动白平衡
        device.whiteBalanceMode = .continuousAutoWhiteBalance
        device.unlockForConfiguration()
    } catch {
        print("设备配置失败: \(error.localizedDescription)")
    }
}

• 自定义图像预处理：在拿到摄像头输出的帧数据后，先用Core Image滤镜增强对比度，再传给二维码检测器。比如用CIColorControls滤镜拉高对比度：

func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) {
    guard let imageBuffer = CMSampleBufferGetImageBuffer(sampleBuffer) else { return }
    let ciImage = CIImage(cvImageBuffer: imageBuffer)
    
    // 增强对比度的滤镜配置
    let contrastFilter = CIFilter(name: "CIColorControls")!
    contrastFilter.setValue(ciImage, forKey: kCIInputImageKey)
    // 对比度值可以根据实际情况调整，1.0是默认，2.0是双倍增强
    contrastFilter.setValue(2.0, forKey: kCIInputContrastKey)
    guard let enhancedImage = contrastFilter.outputImage else { return }
    
    // 用增强后的图像检测二维码
    let detectorOptions = [CIDetectorAccuracy: CIDetectorAccuracyHigh]
    let detector = CIDetector(ofType: CIDetectorTypeQRCode, context: nil, options: detectorOptions)!
    let qrFeatures = detector.features(in: enhancedImage)
    
    // 处理识别到的二维码...
}

• 提高检测精度：初始化CIDetector时，把精度选项设为CIDetectorAccuracyHigh，虽然会增加一点CPU消耗，但对低对比度二维码的识别率提升明显。

更合适的第三方工具包 #

如果调整原生配置后效果还是不理想，这些第三方库对复杂场景的支持更到位：

• ZXingObjC：老牌的条码扫描库，对低对比度、变形、小尺寸二维码的识别能力远超AVFoundation。它支持自定义图像预处理参数，还能指定扫描区域，减少无效检测。
• MLKit Vision：谷歌推出的机器学习视觉工具包，其二维码扫描API内置了优化的识别模型，能自动处理低对比度、模糊等问题，集成起来也比较省心，不需要手动做太多预处理。

额外实用技巧 #

• 引导用户调整扫描姿势：低对比度二维码在某些角度下反光更少，对比度会更明显，可以在界面上提示用户稍微调整手机的角度和距离。
• 自动开启手电筒：如果环境光线较暗，自动检测并开启手电筒，提升画面亮度后，低对比度二维码的识别率会大幅提高。

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