CameraX拍摄图片与预览画面4:3比例不一致问题排查

问题根源分析 #

你的代码存在以下几个关键问题，导致预览和拍照比例/画面不一致：

• 错误修改PreviewView布局参数：手动调整LayoutParams的宽高会破坏PreviewView自身的适配逻辑，CameraX的PreviewView已经内置了比例适配机制，无需硬改尺寸。
• 计算的裁剪矩形未实际应用：calculateCropRect方法算出的Rect没有绑定到Preview或ImageCapture组件，等于无效操作。
• 冗余代码干扰：重复调用preview.setSurfaceProvider(previewView.getSurfaceProvider())属于无意义操作。
• 未同步预览与拍照的尺寸逻辑：虽然都设置了4:3比例，但CameraX可能为Preview和ImageCapture选择不同的硬件支持分辨率，导致画面范围不匹配。

修复方案与代码调整 #

步骤1：修正布局文件

确保activity_main.xml中的PreviewView宽高设为match_parent，让它充满父容器：

<androidx.camera.view.PreviewView
    android:id="@+id/previewView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

步骤2：修改Java代码

移除无效的布局调整和冗余代码，添加预览与拍照的同步逻辑：

public class MainActivity extends AppCompatActivity {
    private ListenableFuture<ProcessCameraProvider> cameraProviderFuture;
    private PreviewView previewView;
    private ImageCapture imageCapture;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        previewView = findViewById(R.id.previewView);

        // 设置PreviewView的缩放模式，保证4:3比例的画面居中裁剪填充
        previewView.setScaleType(PreviewView.ScaleType.CENTER_CROP);

        if (ContextCompat.checkSelfPermission(this, android.Manifest.permission.CAMERA)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{android.Manifest.permission.CAMERA}, 101);
        } else {
            initializeCamera();
        }
    }

    private void initializeCamera() {
        cameraProviderFuture = ProcessCameraProvider.getInstance(this);
        cameraProviderFuture.addListener(() -> {
            try {
                ProcessCameraProvider cameraProvider = cameraProviderFuture.get();
                startCameraX(cameraProvider);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }, ContextCompat.getMainExecutor(MainActivity.this));
    }

    private void startCameraX(ProcessCameraProvider cameraProvider) {
        cameraProvider.unbindAll();

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

        // 初始化Preview，设置4:3比例
        Preview preview = new Preview.Builder()
                .setTargetAspectRatio(AspectRatio.RATIO_4_3)
                .build();

        preview.setSurfaceProvider(previewView.getSurfaceProvider());

        // 初始化ImageCapture，同步4:3比例，并设置裁剪模式保证和预览画面一致
        imageCapture = new ImageCapture.Builder()
                .setCaptureMode(ImageCapture.CAPTURE_MODE_MINIMIZE_LATENCY)
                .setTargetAspectRatio(AspectRatio.RATIO_4_3)
                .setTargetRotation(getWindowManager().getDefaultDisplay().getRotation())
                // 开启裁剪，让拍照输出和预览画面完全匹配
                .setCropAspectRatio(AspectRatio.RATIO_4_3)
                .build();

        cameraProvider.bindToLifecycle(this, cameraSelector, preview, imageCapture);
    }

    public void onCaptureButtonClick(View view) {
        capturePicture();
    }

    private void capturePicture() {
        long timeStamp = System.currentTimeMillis();
        ContentValues contentValues = new ContentValues();
        contentValues.put(MediaStore.MediaColumns.DISPLAY_NAME, "IMG_" + timeStamp);
        contentValues.put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg");

        ImageCapture.OutputFileOptions outputFileOptions = new ImageCapture.OutputFileOptions.Builder(
                getContentResolver(),
                MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                contentValues
        ).build();

        imageCapture.takePicture(
                outputFileOptions,
                ContextCompat.getMainExecutor(this),
                new ImageCapture.OnImageSavedCallback() {
                    @Override
                    public void onImageSaved(@NonNull ImageCapture.OutputFileResults outputFileResults) {
                        runOnUiThread(() -> {
                            Toast.makeText(MainActivity.this, "Photo saved", Toast.LENGTH_SHORT).show();
                        });
                    }

                    @Override
                    public void onError(@NonNull ImageCaptureException exception) {
                        runOnUiThread(() -> {
                            Toast.makeText(MainActivity.this, "Error: " + exception.getMessage(), Toast.LENGTH_SHORT).show();
                        });
                    }
                });
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == 101) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                initializeCamera();
            } else {
                Toast.makeText(this, "Permission Denied", Toast.LENGTH_SHORT).show();
            }
        }
    }
}

关键修正说明

• PreviewView缩放模式：使用CENTER_CROP让4:3的预览画面居中填充整个PreviewView，避免拉伸变形。
• ImageCapture裁剪设置：添加setCropAspectRatio(AspectRatio.RATIO_4_3)，强制拍照输出的画面和预览的裁剪逻辑完全一致。
• 移除无效代码：删掉了手动修改布局参数和重复的SurfaceProvider调用，让CameraX的内置逻辑处理尺寸适配。

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