CameraX捕获图像与PreviewView显示不一致问题求助（Pixel 5a异常）

问题核心原因 #

Pixel设备的Camera HAL对预览和捕获的裁剪逻辑与三星设备存在差异，再加上ViewPort创建时依赖未完成布局测量的PreviewView宽高，最终导致图像捕获后出现左对齐偏移。

具体修复步骤 #

1. 修正ViewPort创建逻辑 #

不要直接使用previewView.getWidth()和previewView.getHeight()生成Rational——此时View可能还未完成布局测量，宽高值不准确。改用预设的4:3比例创建ViewPort，并调整缩放类型保证内容填充对齐：

// 替换原ViewPort创建代码
ViewPort viewPort = new ViewPort.Builder(AspectRatio.RATIO_4_3, preview.getTargetRotation())
        .setScaleType(ViewPort.ScaleType.FILL_CENTER)
        .build();

2. 统一所有Use Case的目标旋转 #

确保ImageCapture的目标旋转与Preview完全同步，避免因旋转参数不一致导致的对齐偏差：

imageCapture = new ImageCapture.Builder()
        .setJpegQuality(100)
        .setTargetAspectRatio(AspectRatio.RATIO_4_3)
        .setTargetRotation(preview.getTargetRotation()) // 新增：同步预览的目标旋转参数
        .setCameraSelector(cameraSelector)
        .build();

3. 显式设置PreviewView的缩放类型 #

在布局或代码中为PreviewView指定缩放类型，强制与ViewPort的缩放逻辑匹配：

<androidx.camera.view.PreviewView
    android:id="@+id/camera_preview"
    android:layout_width="0dp"
    android:layout_height="match_parent"
    android:layout_weight="1"
    app:scaleType="fillCenter" />

或在代码中设置：

previewView.setScaleType(PreviewView.ScaleType.FILL_CENTER);

4. 升级CameraX依赖到最新稳定版 #

旧版本CameraX存在Pixel设备的适配bug，升级依赖可解决部分底层兼容问题：

dependencies {
    def camerax_version = "1.3.0"
    implementation "androidx.camera:camera-core:$camerax_version"
    implementation "androidx.camera:camera-camera2:$camerax_version"
    implementation "androidx.camera:camera-lifecycle:$camerax_version"
    implementation "androidx.camera:camera-view:$camerax_version"
}

5. 验证UseCaseGroup绑定顺序（可选） #

部分设备对UseCase的绑定顺序敏感，确保Preview先于ImageCapture加入组（你的代码已符合此要求，若问题仍存在可尝试交换顺序测试）：

UseCaseGroup useCaseGroup = new UseCaseGroup.Builder()
        .setViewPort(viewPort)
        .addUseCase(preview)
        .addUseCase(imageCapture)
        .build();

完整修正后的代码片段 #

@SuppressLint({"RestrictedApi", "WrongConstant", "UnsafeOptInUsageError"})
private void startCameraX(ProcessCameraProvider cameraProvider) throws ExecutionException, InterruptedException {
    Preview preview = new Preview.Builder()
            .setTargetAspectRatio(AspectRatio.RATIO_4_3)
            .build();
    // 显式设置PreviewView缩放类型
    previewView.setScaleType(PreviewView.ScaleType.FILL_CENTER);
    preview.setSurfaceProvider(previewView.getSurfaceProvider());

    CameraSelector cameraSelector = new CameraSelector.Builder()
            .requireLensFacing(LENS_FACING)
            .build();

    // Image capture use case
    imageCapture = new ImageCapture.Builder()
            .setJpegQuality(100)
            .setTargetAspectRatio(AspectRatio.RATIO_4_3)
            .setTargetRotation(preview.getTargetRotation()) // 同步预览旋转参数
            .setCameraSelector(cameraSelector)
            .build();

    // 基于预设比例创建ViewPort
    ViewPort viewPort = new ViewPort.Builder(AspectRatio.RATIO_4_3, preview.getTargetRotation())
            .setScaleType(ViewPort.ScaleType.FILL_CENTER)
            .build();

    UseCaseGroup useCaseGroup = new UseCaseGroup.Builder()
            .setViewPort(viewPort)
            .addUseCase(preview)
            .addUseCase(imageCapture)
            .build();

    camera = cameraProvider.bindToLifecycle(this, cameraSelector, useCaseGroup);

    CameraControl cameraControl = camera.getCameraControl();
    cameraControl.setLinearZoom(zoom);
    setCaptureRequestOptionsISOandShutterSpeed();
}

内容的提问来源于stack exchange，提问作者Mdohammad Sajib Al Seraj