Camera2 预览中 TextureView 的缩放与旋转校准完整指南-java教程-PHP中文网

本文详解如何在 android camera2 api 中正确配置 textureview 的宽高比和屏幕方向，解决预览图像拉伸、旋转错位及倒置问题，涵盖动态尺寸测量、设备方向适配与纹理视图旋转控制。

本文详解如何在 android camera2 api 中正确配置 textureview 的宽高比和屏幕方向，解决预览图像拉伸、旋转错位及倒置问题，涵盖动态尺寸测量、设备方向适配与纹理视图旋转控制。

在基于 Camera2 构建相机预览时，TextureView 是常用载体，但其默认行为不会自动适配相机输出流的原始宽高比（aspect ratio）和设备物理朝向，导致常见问题：图像水平拉伸、竖屏预览偏转 ±90°、倒置（180°翻转）等。根本原因在于——相机硬件输出的预览尺寸（如 1920×1080）是固定方向的（通常以传感器自然方向为基准），而 UI 容器（TextureView）需根据设备当前屏幕方向（ROTATION_0/90/180/270）和应用窗口布局进行双重对齐。

✅ 正确设置宽高比：动态匹配预览尺寸

关键不是硬编码比例，而是依据 CaptureRequest.Builder 所用的 PreviewSize（即 StreamConfigurationMap.getOutputSizes(SurfaceTexture.class) 返回的最佳尺寸）实时计算。尤其注意：相机预览尺寸本身不随设备旋转而改变，但 UI 布局方向会变。因此，在 onMeasure() 中需先判断当前屏幕方向，再交换宽高逻辑以匹配“视觉上的预览比例”。

@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    int width = MeasureSpec.getSize(widthMeasureSpec);
    int height = MeasureSpec.getSize(heightMeasureSpec);

    if (mPreviewSize != null) {
        int previewWidth = mPreviewSize.getWidth();
        int previewHeight = mPreviewSize.getHeight();

        // 根据当前屏幕方向调整预览尺寸的“视觉宽高”映射
        // Camera sensor 输出是固定的，但用户看到的“宽”取决于屏幕朝向
        Display display = getWindowManager().getDefaultDisplay();
        int rotation = display.getRotation();
        boolean isLandscape = (rotation == Surface.ROTATION_0 || rotation == Surface.ROTATION_180)
                ? width > height : width  height * previewWidth) {
            // 高度受限 → 按高度反推宽度
            width = height * previewWidth / previewHeight;
        } else {
            // 宽度受限 → 按宽度反推高度
            height = width * previewHeight / previewWidth;
        }
    }

    setMeasuredDimension(width, height);
}

⚠️ 注意事项：

mPreviewSize 必须在 configureOutputs() 或 createCaptureSession() 前已通过 StreamConfigurationMap 获取并缓存；

不要直接使用 getResources().getConfiguration().orientation，它返回的是 ORIENTATION_LANDSCAPE/PORTRAIT，滞后且不可靠；应使用 Display.getRotation() 获取实时物理旋转；

此方案实现的是 “居中裁剪”式适配（类似 ImageView 的 CENTER_CROP），确保无拉伸、无黑边，但可能裁切边缘内容——这是 Camera2 预览的标准实践。

✅ 正确处理旋转：TextureView 旋转优于 JPEG_ORIENTATION

许多开发者误以为设置 JPEG_ORIENTATION 就能修正预览方向，但该参数仅影响 JPEG 编码输出（如拍照结果），对 SurfaceTexture 预览流完全无效。预览方向必须由 TextureView 自身的 setRotation() 控制，并与设备 Display.Rotation 和相机传感器方向（CameraCharacteristics.SENSOR_ORIENTATION）协同计算。

标准校准公式如下（适用于大多数设备）：

private void updateTextureViewRotation() {
    if (textureView == null || mPreviewSize == null) return;

    Display display = getWindowManager().getDefaultDisplay();
    int deviceRotation = display.getRotation(); // 0, 90, 180, 270
    int sensorOrientation = mCharacteristics.get(CameraCharacteristics.SENSOR_ORIENTATION); // e.g., 90 or 270

    // Camera2 要求：TextureView 旋转角度 = (sensorOrientation - deviceRotation + 360) % 360
    // 但需注意：TextureView 旋转后，触摸坐标系也会旋转，若需交互需额外校准
    int rotationCompensation = (sensorOrientation - deviceRotation + 360) % 360;

    // 对于前置摄像头，还需镜像翻转（仅视觉，不影响预览流数据）
    boolean isFrontFacing = mCharacteristics.get(CameraCharacteristics.LENS_FACING) 
            == CameraCharacteristics.LENS_FACING_FRONT;
    if (isFrontFacing) {
        rotationCompensation = (rotationCompensation + 180) % 360;
        textureView.setScaleX(-1f); // 水平镜像（仅视觉）
    } else {
        textureView.setScaleX(1f);
    }

    textureView.setRotation(rotationCompensation);
}

✅ 最佳实践建议：

在 onResume()、屏幕旋转监听（onConfigurationChanged）及 onDisplayChanged 回调中调用 updateTextureViewRotation()；

若使用 CameraCaptureSession.setRepeatingRequest()，确保旋转更新在 session 创建之后、首帧渲染之前完成；

前置摄像头需额外水平镜像（setScaleX(-1f)），否则自拍镜像异常；

JPEG_ORIENTATION 仍需在拍照时单独设置（用于 EXIF 方向标记），与预览无关。

✅ 总结：三步闭环校准

步骤	关键动作	目标
1. 尺寸对齐	onMeasure() 动态计算宽高，按 Display.getRotation() 适配预览尺寸视觉比例	消除拉伸、黑边，实现无损居中预览
2. 视图旋转	TextureView.setRotation() 结合 SENSOR_ORIENTATION 与 Display.Rotation 计算补偿角	确保预览画面始终“正立”，方向与用户视角一致
3. 镜像处理（可选）	前置摄像头 setScaleX(-1f) + 旋转补偿微调	实现符合直觉的自拍镜像效果

遵循上述逻辑，即可彻底解决 Camera2 预览中长期困扰开发者的缩放失真与方向错乱问题，构建专业、稳定、跨机型兼容的相机界面。