如何处理ML Kit条码扫描器受损条码并优化错误回调逻辑

一、修改代码实现仅主动扫描失败时触发error() #

当前代码每帧都会执行analyze方法，导致未主动扫描时也会触发error()。核心解决思路是增加主动扫描状态标记，仅当用户触发扫描操作时才处理扫描结果并判断是否调用error()。

具体修改步骤： #

1. 在Image Analyser类中添加原子布尔变量记录扫描状态（保证线程安全，相机回调与UI操作在不同线程）：

private val isScanning = AtomicBoolean(false)

2. 提供外部调用方法，供用户触发扫描（比如点击扫描按钮时调用）：

fun startScan() {
    isScanning.set(true)
}

3. 修改analyze方法，仅在主动扫描状态下处理结果：

@SuppressLint("UnsafeOptInUsageError")
override fun analyze(imageProxy: ImageProxy) {
    val mediaImage = imageProxy.image
    if (mediaImage != null) {
        InputImage.fromMediaImage(mediaImage, imageProxy.imageInfo.rotationDegrees)
            .let { image ->
                scanner.process(image)
                    .addOnSuccessListener { barcodes ->
                        // 仅处于主动扫描状态时处理结果
                        if (isScanning.get()) {
                            if (barcodes.isNotEmpty()) {
                                barcodes.forEach { barcode ->
                                    onResult(barcode.rawValue ?: "")
                                }
                            } else {
                                // 主动扫描无结果，触发error回调
                                error()
                            }
                            // 扫描完成，重置状态标记
                            isScanning.set(false)
                        }
                    }
                    .addOnFailureListener {
                        Log.e(ContentValues.TAG, "Use case binding failed $it")
                        // 扫描失败时重置状态标记
                        if (isScanning.get()) {
                            isScanning.set(false)
                        }
                    }
                    .addOnCompleteListener {
                        CoroutineScope(Dispatchers.IO).launch {
                            delay(delayForProcessingNextImage)
                            imageProxy.close()
                        }
                    }
            }
    } else {
        Log.e(ContentValues.TAG, "Image is empty")
        // 图像为空且处于扫描状态，重置标记
        if (isScanning.get()) {
            isScanning.set(false)
        }
    }
}

逻辑说明： #

• 用户点击扫描按钮时，调用startScan()将isScanning设为true，开启单次扫描检测。
• analyze方法仅在isScanning为true时，才会根据条码结果判断是否触发error()。
• 无论扫描成功、失败或图像为空，只要处于扫描状态，都会在处理完成后重置isScanning，避免后续帧误触发。

二、ML Kit受损条码处理方案 #

针对受损条码（模糊、残缺、反光等），可以通过以下方式提升识别率：

1. 调整ML Kit扫描配置 #

启用ML Kit的潜在条码检测功能，该功能会识别更多可能的受损条码（代价是可能增加误识别率，需根据业务场景权衡）：

val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_ALL_FORMATS) // 按需设置支持的条码格式
    .enableAllPotentialBarcodes() // 开启潜在条码检测
    .build()
val scanner = BarcodeScanning.getClient(options)

2. 图像预处理 #

在将图像传入ML Kit前，对图像做预处理，增强条码辨识度：

// 示例：灰度化+提高对比度
fun preprocessImage(bitmap: Bitmap): Bitmap {
    // 转为灰度图
    val grayBitmap = Bitmap.createBitmap(bitmap.width, bitmap.height, Bitmap.Config.ARGB_8888)
    Canvas(grayBitmap).apply {
        val paint = Paint().apply {
            colorFilter = ColorMatrixColorFilter(ColorMatrix().apply { setSaturation(0f) })
        }
        drawBitmap(bitmap, 0f, 0f, paint)
    }

    // 提高对比度
    val contrastBitmap = Bitmap.createBitmap(grayBitmap.width, grayBitmap.height, Bitmap.Config.ARGB_8888)
    Canvas(contrastBitmap).apply {
        val paint = Paint().apply {
            colorFilter = ColorMatrixColorFilter(ColorMatrix().apply { setScale(1.2f, 1.2f, 1.2f, 1f) })
        }
        drawBitmap(grayBitmap, 0f, 0f, paint)
    }

    return contrastBitmap
}

在analyze方法中使用预处理后的图像：

val bitmap = mediaImage.toBitmap()
val processedBitmap = preprocessImage(bitmap)
val image = InputImage.fromBitmap(processedBitmap, imageProxy.imageInfo.rotationDegrees)

3. 多帧扫描验证 #

主动扫描时连续检测多帧图像，只要有一帧识别到条码就返回结果，仅当所有帧都失败时才触发error()：

// 新增扫描尝试次数计数器
private val scanAttempts = AtomicInteger(0)
private const val MAX_SCAN_ATTEMPTS = 3

fun startScan() {
    isScanning.set(true)
    scanAttempts.set(MAX_SCAN_ATTEMPTS) // 初始化尝试次数
}

修改addOnSuccessListener中的逻辑：

if (isScanning.get()) {
    if (barcodes.isNotEmpty()) {
        barcodes.forEach { barcode ->
            onResult(barcode.rawValue ?: "")
        }
        isScanning.set(false)
        scanAttempts.set(0)
    } else {
        val remaining = scanAttempts.decrementAndGet()
        if (remaining <= 0) {
            error()
            isScanning.set(false)
        }
        // 还有剩余尝试次数，继续等待下一帧
    }
}

4. 用户引导提示 #

当扫描失败时，提示用户调整：

• 保持条码在扫描框内
• 调整距离，让条码清晰显示
• 避免强光或反光
• 调整角度，让条码平行于扫描框

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