如何调优Android MLKit/ZXing二维码扫描实现以识别特殊二维码？

我按照教程实现了二维码扫描器，整体运行正常，但存在一个二维码无法识别（该二维码可被系统相机正常识别）。我尝试过MLKit的bundled版本和GMS版本，ZXing也无法解析该二维码，恳请提供调优实现的建议。

我的代码：

private fun startCamera() {
    val cameraController = LifecycleCameraController(context)

    cameraController.setImageAnalysisAnalyzer(
        ContextCompat.getMainExecutor(context),
        QrCodeAnalyzer { value ->
            onDecode?.invoke(value)
            onDecode = null
        }
    )

    cameraController.bindToLifecycle(this)
    preview.controller = cameraController
}

class QrCodeAnalyzer(
    private val onQrCodesDetected: (qrCode: String) -> Unit,
) : ImageAnalysis.Analyzer {

    private val options = BarcodeScannerOptions.Builder()
        .setBarcodeFormats(Barcode.FORMAT_QR_CODE)
        .build()

    private val scanner = BarcodeScanning.getClient(options)

    @ExperimentalGetImage
    override fun analyze(image: ImageProxy) {
        image.image?.let { img ->
            val inputImage = InputImage.fromMediaImage(img, image.imageInfo.rotationDegrees)

            scanner.process(inputImage)
                .addOnSuccessListener { barcodes ->
                    barcodes.firstNotNullOfOrNull { it.rawValue }?.let { onQrCodesDetected(it) }
                }
                .addOnCompleteListener {
                    image.close()
                }
        }
    }

    override fun getDefaultTargetResolution(): Size? {
        return Size(1080, 1920)
    }
}

调优建议 #

• 调整图像分析分辨率：当前固定的1080x1920分辨率可能不是相机的最优输出，可尝试注释掉getDefaultTargetResolution的实现，让系统自动选择合适分辨率；或换成720p（Size(720, 1280)）测试，部分二维码在特定分辨率下识别率更高。

• 增加图像预处理步骤：系统相机通常会自动做曝光、对比度增强等优化，你可以在分析前对图像做灰度化、对比度调整或锐化处理。例如将MediaImage转为Bitmap，通过ColorMatrix转为灰度图后，再用InputImage.fromBitmap创建输入图像传给扫描器。

• 优化扫描器配置：在MLKit的BarcodeScannerOptions中，尝试启用enableAllPotentialBarcodes()（若适用），或缩小扫描区域至画面中心，减少无关区域干扰，提升识别精准度。

• 添加多帧重试机制：当前代码识别一次后就停止（onDecode = null），可取消该设置，让扫描器连续分析多帧，避免单帧模糊、角度偏差导致的识别失败，直到成功识别后再停止分析。

• 验证图像旋转角度：确认image.imageInfo.rotationDegrees是否正确传递给InputImage，错误的旋转角度会导致二维码方向错位，无法被识别。可打印日志查看旋转角度是否与实际画面匹配。

• 尝试MLKit备选扫描模式：暂时不指定二维码格式，让扫描器自动检测所有条码类型，或检查是否有其他隐藏配置项可提升识别能力。

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