CameraX输出图像分辨率低于设备原生相机如何配置解决

问题现象 #

• 开发场景：Android端基于CameraX实现自定义相机模块
• 测试环境：Moto G10 power设备
• 表现差异：
  • 竖屏使用系统原生相机拍摄，输出图像分辨率为3000*4000
  • 自研CameraX模块竖屏拍摄仅输出2250*4000分辨率图像，与原生结果存在明显差距
• 预期目标：CameraX拍摄输出分辨率与系统原生相机保持一致
• 当前ImageCapture配置代码：

ImageCapture imageCapture = builder
    .setCaptureMode(ImageCapture.CAPTURE_MODE_MAXIMIZE_QUALITY)
    .setTargetAspectRatio(aspectRatio) // 根据设备方向传0(4:3)或1(16:9)
    .setTargetRotation(previewView.getDisplay().getRotation())
    .setFlashMode(getFlashMode())
    .build();

• 已尝试无效方案：将setTargetAspectRatio(aspectRatio)替换为setTargetResolution(new Size(3000, 4000))，最终仅输出960*720分辨率图像。

核心原因 #

CameraX不会强制输出传入的目标分辨率，它会从相机硬件支持的输出尺寸列表中，选择同时满足所有绑定用例约束、与配置参数最匹配的尺寸，问题来自三个常见配置误区：

1. 比例配置错误：当前拿到的22504000是16:9比例下的最高输出，而原生相机默认输出的30004000是4:3比例，竖屏状态下如果错误传入16:9的比例参数，永远无法匹配到原生默认的分辨率。
2. 传入的目标分辨率宽高顺序错误：setTargetResolution接收的Size参数是相机传感器自然方向的尺寸，手机后置传感器默认是横向排布，需要的竖屏30004000对应传感器原生尺寸为40003000，宽高写反后CameraX找不到匹配尺寸，会自动降级到低分辨率通用配置，这就是传了3000*4000反而出720p的核心原因。
3. 多用例约束冲突：如果同时绑定了Preview（预览）、ImageAnalysis（图像分析）用例，且没有给这些用例单独配置分辨率规则，CameraX会选择能同时满足所有用例的公共分辨率，很容易拉低ImageCapture的分辨率上限。

可落地的配置步骤 #

• 不要同时设置setTargetAspectRatio和setTargetResolution，两个参数互斥，同时配置会触发参数校验失败，走默认降级逻辑。
• 不要硬编码分辨率，先查询硬件实际支持的JPEG输出尺寸：

// 获取对应相机的硬件支持信息
CameraSelector backCamera = CameraSelector.DEFAULT_BACK_CAMERA;
CameraInfo cameraInfo = cameraProvider.getCameraInfo(backCamera);
StreamConfigurationMap configMap = cameraInfo.getCameraCharacteristics()
        .get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
// 获取所有支持的JPEG格式输出尺寸
Size[] supportedJpegSizes = configMap.getOutputSizes(ImageFormat.JPEG);

• 从支持的尺寸列表中筛选4:3比例下的最高分辨率，这个尺寸就是系统原生相机默认使用的拍摄尺寸（Moto G10 power上这个值就是传感器方向的40003000，竖屏旋转后正好是30004000）。
• 给ImageCapture单独设置筛选出来的目标分辨率，其余用例（预览、图像分析）单独配置自身需要的分辨率/比例，不要和ImageCapture共用配置，避免约束冲突。
• 保留原有setTargetRotation配置即可，这个参数只用于告诉CameraX当前屏幕方向，给输出图像添加正确的方向标记，不会影响传感器实际输出的分辨率。
• 注意链式调用的写法正确性，不要在build过程中重复调用builder对象，避免参数不生效。

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