Android调用摄像头扫描二维码时，如何解决扫码区域与预览画面不一致的问题？

Question

在Android开发中，调用摄像头扫描二维码时，常遇到扫码区域与预览画面不一致的问题。这主要是由于屏幕方向、相机传感器方向及预览画面缩放比例不同导致的。例如，当设备旋转时，预览画面可能未正确调整，致使扫码框偏离实际扫描区域。 解决此问题的关键在于： 1. **同步屏幕方向和相机方向**：根据`OrientationEventListener`获取设备方向，并通过`setRotation`调整相机预览方向。 2. **设置正确的预览尺寸**：选择最接近屏幕宽高比的相机支持分辨率，避免画面拉伸或裁剪。 3. **动态调整扫码框位置**：基于预览画面的实际坐标系，计算扫码框在相机坐标中的映射区域。 通过以上方法，可确保扫码区域与预览画面精准对齐，提升用户体验。

Answer 1

1. 问题概述：扫码区域与预览画面不一致

在Android开发中，调用摄像头扫描二维码时，常遇到扫码区域与预览画面不一致的问题。这主要是由于屏幕方向、相机传感器方向及预览画面缩放比例不同导致的。例如，当设备旋转时，预览画面可能未正确调整，致使扫码框偏离实际扫描区域。

以下是可能导致该问题的主要原因：

• 屏幕方向与相机传感器方向不一致。
• 预览尺寸与屏幕分辨率比例不匹配，导致画面拉伸或裁剪。
• 扫码框位置未根据预览画面的实际坐标系动态调整。

2. 同步屏幕方向和相机方向

解决扫码区域与预览画面不一致的第一个关键步骤是同步屏幕方向和相机方向。通过`OrientationEventListener`获取设备方向，并使用`setRotation`方法调整相机预览方向。

    OrientationEventListener orientationEventListener = new OrientationEventListener(this) {
        @Override
        public void onOrientationChanged(int orientation) {
            if (orientation == ORIENTATION_UNKNOWN) return;
            int rotation = getWindowManager().getDefaultDisplay().getRotation();
            camera.setDisplayOrientation(calculateCameraAngle(rotation));
        }
    };

    private int calculateCameraAngle(int rotation) {
        switch (rotation) {
            case Surface.ROTATION_0: return 90;
            case Surface.ROTATION_90: return 0;
            case Surface.ROTATION_180: return 270;
            case Surface.ROTATION_270: return 180;
        }
        return 90;
    }
    

3. 设置正确的预览尺寸

选择最接近屏幕宽高比的相机支持分辨率，避免画面拉伸或裁剪。以下代码展示了如何计算最佳预览尺寸：

屏幕宽高比	相机支持分辨率	最佳匹配
16:9	1920x1080, 1280x720	1280x720
4:3	1024x768, 800x600	800x600

代码实现如下：

    List supportedPreviewSizes = parameters.getSupportedPreviewSizes();
    Camera.Size optimalSize = getOptimalPreviewSize(supportedPreviewSizes, screenWidth, screenHeight);

    private Camera.Size getOptimalPreviewSize(List sizes, int w, int h) {
        final double ASPECT_TOLERANCE = 0.1;
        double targetRatio = (double) w / h;
        if (sizes == null) return null;

        Camera.Size optimalSize = null;
        double minDiff = Double.MAX_VALUE;

        for (Camera.Size size : sizes) {
            double ratio = (double) size.width / size.height;
            if (Math.abs(ratio - targetRatio) > ASPECT_TOLERANCE) continue;
            if (Math.abs(size.height - h) < minDiff) {
                optimalSize = size;
                minDiff = Math.abs(size.height - h);
            }
        }
        return optimalSize;
    }
    

4. 动态调整扫码框位置

基于预览画面的实际坐标系，计算扫码框在相机坐标中的映射区域。以下是动态调整扫码框位置的核心逻辑：

graph TD;
            A[获取预览画面尺寸] --> B[计算扫码框坐标];
            B --> C[映射到相机坐标系];
            C --> D[调整扫码框位置];

具体实现如下：

    Rect previewFrame = new Rect(0, 0, previewWidth, previewHeight);
    Rect scanBox = new Rect(scanBoxLeft, scanBoxTop, scanBoxRight, scanBoxBottom);

    // 映射扫码框到相机坐标系
    float scale = (float) previewWidth / cameraPreviewSize.width;
    int mappedLeft = (int) (scanBox.left / scale);
    int mappedTop = (int) (scanBox.top / scale);
    int mappedRight = (int) (scanBox.right / scale);
    int mappedBottom = (int) (scanBox.bottom / scale);

    Rect mappedScanBox = new Rect(mappedLeft, mappedTop, mappedRight, mappedBottom);