如何使用Google ML Kit扫描反色Data Matrix条码（Android Java）

ML Kit 默认仅优化了深色条码+浅色背景的识别逻辑，反色（白码黑底）的 Data Matrix 需要通过图像预处理或针对性配置来解决，以下是可落地的解决方案：

1. 图像反色预处理（核心步骤） #

针对 Bitmap 或相机预览的 YUV 数据进行反色处理，将白码黑底转换为 ML Kit 适配的黑码白底：

处理 Bitmap 图像 #

使用 ColorMatrix 高效反色，避免逐像素遍历的性能损耗：

public Bitmap invertBitmap(Bitmap originalBitmap) {
    ColorMatrix invertMatrix = new ColorMatrix(new float[]{
        -1.0f, 0.0f, 0.0f, 0.0f, 255.0f,
        0.0f, -1.0f, 0.0f, 0.0f, 255.0f,
        0.0f, 0.0f, -1.0f, 0.0f, 255.0f,
        0.0f, 0.0f, 0.0f, 1.0f, 0.0f
    });
    Paint paint = new Paint();
    paint.setColorFilter(new ColorMatrixColorFilter(invertMatrix));
    
    Bitmap invertedBitmap = Bitmap.createBitmap(
        originalBitmap.getWidth(), 
        originalBitmap.getHeight(), 
        originalBitmap.getConfig()
    );
    Canvas canvas = new Canvas(invertedBitmap);
    canvas.drawBitmap(originalBitmap, 0, 0, paint);
    return invertedBitmap;
}

处理相机预览 YUV 数据（更高效） #

如果是实时相机检测，直接修改 YUV 数据的 Y 通道（亮度通道）即可，无需转换为 Bitmap：

// 针对 NV21 格式的 YUV 数据反色
public byte[] invertNV21YUV(byte[] yuvData, int width, int height) {
    // Y 通道占前 width*height 字节，直接反色
    int yChannelSize = width * height;
    for (int i = 0; i < yChannelSize; i++) {
        yuvData[i] = (byte) (255 - (yuvData[i] & 0xFF));
    }
    return yuvData;
}

2. ML Kit 检测配置优化 #

明确指定检测格式为 Data Matrix，避免ML Kit浪费资源在其他条码格式上，提升检测精度：

// 构建条码扫描配置
BarcodeScannerOptions options = new BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_DATA_MATRIX)
    .build();

// 初始化扫描器
BarcodeScanner scanner = BarcodeScanning.getClient(options);

// 传入预处理后的图像进行检测
Task<List<Barcode>> result = scanner.process(image)
    .addOnSuccessListener(barcodes -> {
        // 处理识别结果
        for (Barcode barcode : barcodes) {
            String rawValue = barcode.getRawValue();
            // 业务逻辑处理
        }
    })
    .addOnFailureListener(e -> {
        // 处理识别失败
    });

3. 关键调试要点 #

• 验证预处理结果：将反色后的图像保存到本地（如 MediaStore），确认图像已正确转换为黑码白底，排除预处理错误。
• 纠正图像方向：相机预览帧可能存在旋转偏移，需根据设备传感器方向旋转图像后再预处理，避免条码因旋转无法被识别：

  public Bitmap rotateBitmap(Bitmap bitmap, int rotationDegrees) {
      Matrix matrix = new Matrix();
      matrix.postRotate(rotationDegrees);
      return Bitmap.createBitmap(bitmap, 0, 0, bitmap.getWidth(), bitmap.getHeight(), matrix, true);
  }
  

• 更新ML Kit依赖：确保使用最新版本的条码扫描库，避免旧版本的兼容问题，比如当前最新版：

  dependencies {
      implementation 'com.google.mlkit:barcode-scanning:17.2.0'
  }
  

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