Android Studio结合Zxing无法扫描二维码问题求助

核心问题分析 #

你的二维码扫描器无法识别内容为hello的二维码，主要源于三个关键问题：

• YUV图像步长未正确处理：CameraX输出的YUV平面数据中，buffer的实际行步长（每行字节数）通常不等于图像宽度，直接转换为ByteArray会导致图像数据错位，ZXing无法解析正确的图像结构。
• 未处理图像旋转：Android相机采集的图像会根据设备方向自动旋转，你的代码未将旋转信息传递给ZXing，导致二维码处于旋转状态无法被识别。
• 解码策略容错率不足：默认解码参数对低对比度、小尺寸二维码的识别能力有限，需要启用更激进的解码策略。

具体修复步骤 #

1. 正确处理YUV平面的步长 #

修改QrCodeAnalyzer中YUV数据的提取逻辑，基于plane.rowStride和plane.pixelStride构建正确的图像字节数组，避免数据错位。

2. 适配图像旋转角度 #

利用ImageProxy.rotationDegrees调整LuminanceSource的旋转角度，确保ZXing接收到正向的二维码图像。

3. 添加激进解码提示 #

在MultiFormatReader的解码配置中加入TRY_HARDER参数，提升识别的容错率。

4. 修正图像分析分辨率设置 #

MainActivity中ImageAnalysis的目标分辨率初始化时，previewView.width/height可能为0，改用宽高比配置保证图像参数正确。

修改后的完整代码 #

QrCodeAnalyzer.kt #

package com.plcoding.qrcodescannercompose

import android.graphics.ImageFormat
import androidx.camera.core.ImageAnalysis
import androidx.camera.core.ImageProxy
import com.google.zxing.*
import com.google.zxing.common.HybridBinarizer
import java.nio.ByteBuffer

class QrCodeAnalyzer(
    private val onQrCodeScanned: (String) -> Unit
): ImageAnalysis.Analyzer {

    private val supportedImageFormats = listOf(
        ImageFormat.YUV_420_888,
        ImageFormat.YUV_422_888,
        ImageFormat.YUV_444_888,
    )

    override fun analyze(image: ImageProxy) {
        if(image.format in supportedImageFormats) {
            val plane = image.planes.first()
            val buffer = plane.buffer
            val rowStride = plane.rowStride
            val pixelStride = plane.pixelStride

            // 处理YUV数据，修正步长导致的图像错位
            val bytes = ByteArray(image.width * image.height)
            var bufferIndex = 0
            var outputIndex = 0

            for (y in 0 until image.height) {
                for (x in 0 until image.width) {
                    bytes[outputIndex] = buffer.get(bufferIndex)
                    outputIndex++
                    bufferIndex += pixelStride
                }
                bufferIndex += rowStride - image.width * pixelStride
            }

            // 创建LuminanceSource并适配图像旋转
            var source = PlanarYUVLuminanceSource(
                bytes,
                image.width,
                image.height,
                0,
                0,
                image.width,
                image.height,
                false
            )

            source = when(image.rotationDegrees) {
                90 -> source.rotateCounterClockwise()
                180 -> source.rotateCounterClockwise().rotateCounterClockwise()
                270 -> source.rotateCounterClockwise().rotateCounterClockwise().rotateCounterClockwise()
                else -> source
            }

            val binaryBmp = BinaryBitmap(HybridBinarizer(source))
            try {
                val result = MultiFormatReader().apply {
                    setHints(
                        mapOf(
                            DecodeHintType.POSSIBLE_FORMATS to arrayListOf(BarcodeFormat.QR_CODE),
                            DecodeHintType.TRY_HARDER to true // 启用激进解码策略
                        )
                    )
                }.decode(binaryBmp)
                onQrCodeScanned(result.text)
            } catch(e: Exception) {
                e.printStackTrace()
            } finally {
                image.close()
            }
        }
    }
}

MainActivity.kt 关键修改 #

// 替换原来的setTargetResolution，改用宽高比配置
val imageAnalysis = ImageAnalysis.Builder()
    .setTargetAspectRatio(AspectRatio.RATIO_16_9)
    .setBackpressureStrategy(STRATEGY_KEEP_ONLY_LATEST)
    .build()

验证说明 #

修改后，ZXing会正确处理相机输出的YUV数据和旋转角度，同时启用更高容错的解码策略，应该能成功识别设备自带相机可识别的hello二维码。

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