iOS AVFoundation无法识别带颜色渐变的QR码如何解决

核心原因 #

iOS 15及更早版本的AVFoundation原生二维码识别算法，默认仅针对高对比度的黑白QR码做了优化，本身就不支持低对比度的彩色、渐变QR码识别，属于系统层级的能力限制，和Xcode开发版本没有直接关联。苹果在iOS 16的AVFoundation迭代中才针对性优化了QR码识别逻辑，新增了对彩色、带logo、渐变QR码的识别支持，同一张渐变QR码在iOS 16及以上版本的设备上可以直接用原生能力正常识别。

排查配置项 #

先确认你的AVFoundation配置没有以下疏漏：

• 检查AVCaptureMetadataOutput的metadataObjectTypes属性是否明确包含了AVMetadataObjectTypeQRCode
• 不要把识别范围rectOfInterest设置成全屏幕，缩小到取景框对应的区域，减少背景色干扰，可小幅度提升彩色码的识别概率
• 可以尝试调高摄像头采集的对比度参数，降低渐变区域的识别难度

兼容iOS 15的解决方案 #

如果你的应用需要支持iOS 15及更低版本，可以采用以下方案解决：

1. 对采集到的视频帧做预处理：在AVCaptureOutput的代理回调中，先将CMSampleBuffer转换为灰度图，手动拉升对比度后再交给识别模块处理
2. 引入第三方二维码识别库替代原生识别能力，常见的ZXingObjC、微信开源QR扫描组件的识别算法对彩色、渐变QR码的兼容度远高于iOS 15的原生识别
3. 做版本分支判断：iOS 16及以上版本走原生AVFoundation识别，低于iOS 16的版本走第三方库识别，兼顾性能和兼容性

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