Android Camerax PreviewConfig 使用OptionsBundle时如何设置分辨率？

Question

在使用Android CameraX的PreviewConfig时，如何通过OptionsBundle设置特定分辨率是一个常见问题。尽管CameraX提供了高层次的API以简化相机操作，但有时开发者需要更精细的控制，例如指定预览分辨率。 问题是：如何利用OptionsBundle在PreviewConfig中设置自定义分辨率？ 通常，CameraX会自动选择最佳分辨率，但如果想手动设置，可以借助OptionsBundle。首先，创建一个PreviewConfig对象，然后通过OptionsBundle插入目标分辨率参数（如“androidx.camera.core.impl.CameraCaptureCallback.KEY_OUTPUT_SIZE”）。需要注意的是，所选分辨率必须与设备支持的配置兼容，否则可能导致错误或不一致行为。此外，部分设备可能对分辨率有特定限制，建议先查询设备支持的尺寸列表，确保设置的分辨率有效。 此方法为开发者提供灵活控制的同时，也要求对设备能力和CameraX内部机制有一定了解。

Answer 1

1. 初步了解：CameraX与PreviewConfig

CameraX是Android Jetpack的一部分，旨在简化相机应用的开发。它提供了一个高层次的API，允许开发者更轻松地处理常见的相机功能，例如预览、拍照和视频录制。

在CameraX中，PreviewConfig用于配置预览用例。默认情况下，CameraX会自动选择一个适合设备的分辨率进行预览。然而，在某些场景下，开发者可能需要手动指定预览分辨率以满足特定需求。

OptionsBundle是一种灵活的工具，可以用来插入自定义参数到CameraX配置中。通过它，我们可以设置诸如分辨率等高级选项。

• CameraX的核心目标是跨设备一致性。
• OptionsBundle允许开发者对内部参数进行更精细的控制。

2. 问题分析：为何需要自定义分辨率

尽管CameraX提供了自动分辨率选择功能，但以下情况可能需要手动设置：

1. 优化性能：在低功耗模式下使用较低分辨率。
2. 适配UI：确保预览尺寸与界面布局完全匹配。
3. 兼容性：部分设备可能无法支持默认选择的分辨率。

为了实现这些目标，我们需要借助OptionsBundle将自定义分辨率参数传递给PreviewConfig。

在此过程中，必须注意：

注意事项	原因
查询设备支持的分辨率列表	避免设置不被支持的分辨率导致错误
确保分辨率符合设备能力	部分设备可能对分辨率有特定限制

3. 解决方案：如何利用OptionsBundle设置自定义分辨率

以下是具体步骤，展示如何通过OptionsBundle在PreviewConfig中设置自定义分辨率：

// 步骤1：创建PreviewConfig对象
PreviewConfig previewConfig = new PreviewConfig.Builder()
    .setLensFacing(CameraX.LensFacing.BACK)
    .build();

// 步骤2：获取设备支持的分辨率列表
StreamConfigurationMap map = cameraCharacteristics.get(
    CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
Size[] sizes = map.getOutputSizes(SurfaceTexture.class);

// 步骤3：选择合适的分辨率
Size customResolution = null;
for (Size size : sizes) {
    if (size.getWidth() == 1920 && size.getHeight() == 1080) { // 示例：选择1080p
        customResolution = size;
        break;
    }
}

// 步骤4：通过OptionsBundle插入自定义分辨率
if (customResolution != null) {
    OptionsBundle optionsBundle = new OptionsBundle();
    optionsBundle.insert(androidx.camera.core.impl.CameraCaptureCallback.KEY_OUTPUT_SIZE, customResolution);
    previewConfig = new PreviewConfig.Builder(previewConfig, optionsBundle).build();
}

上述代码展示了如何查询设备支持的分辨率，并通过OptionsBundle将选定的分辨率插入到PreviewConfig中。

4. 深入探讨：潜在问题与解决方案

在实际开发中，可能会遇到以下问题：

• 设备不支持指定分辨率：建议从设备支持的分辨率列表中选择最接近的目标分辨率。
• 性能问题：高分辨率可能导致帧率下降，需权衡性能与画质需求。

以下是设备支持分辨率的查询流程图：

graph TD;
    A[开始] --> B{设备是否支持CameraX};
    B --否--> C[终止];
    B --是--> D[获取CameraCharacteristics];
    D --> E[查询SCALER_STREAM_CONFIGURATION_MAP];
    E --> F[列出支持的分辨率];
    F --> G[选择目标分辨率];
    G --> H[完成];