Android Camera2自定义白平衡失控求助：如何禁用色彩校正？

阿华AIGC实验室

2026-5-20

解决Camera2中色彩校正不受控制的问题

看起来你在使用Camera2 API的TEMPLATE_STILL_CAPTURE模板做持续图像捕获时，遇到了色彩校正无法手动控制的问题——这其实是因为这个模板默认会开启一系列自动优化（包括色彩、白平衡、曝光等），仅仅关闭自动对焦（AF）是不够的。下面给你具体的解决思路和代码示例：

核心问题分析

TEMPLATE_STILL_CAPTURE是为单张高质量静态照片设计的模板，它会自动启用自动白平衡（AWB）、自动色彩校正、**自动曝光（AE）**等一系列自动控制逻辑，这些默认设置会覆盖你可能想手动调整的色彩相关参数。如果你需要持续捕获未修改的原始风格图像，要么修改这个模板的默认参数，要么换用更适合持续流的TEMPLATE_PREVIEW模板。

具体解决方案

1. 覆盖自动色彩相关的控制参数

在创建CaptureRequest之后，手动关闭自动色彩相关的模块，并设置固定参数：

// 初始化请求构建器（用STILL_CAPTURE或PREVIEW模板都可以，根据你的场景选）
CaptureRequest.Builder captureRequest = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE);

// 关闭自动对焦（你已有的代码）
captureRequest.set(CaptureRequest.CONTROL_AF_MODE, CameraMetadata.CONTROL_AF_MODE_OFF);

// -------------------------- 新增色彩控制相关设置 --------------------------
// 1. 关闭自动白平衡，手动指定色温（比如日光5500K）
captureRequest.set(CaptureRequest.CONTROL_AWB_MODE, CameraMetadata.CONTROL_AWB_MODE_OFF);
// 可选：用预设色温，比如日光、阴天、钨丝灯等，也可以直接设置自定义增益
captureRequest.set(CaptureRequest.CONTROL_AWB_PRESET, CameraMetadata.CONTROL_AWB_PRESET_DAYLIGHT);

// 2. 关闭自动色彩校正，手动设置色彩转换矩阵（用单位矩阵表示不做校正，保留传感器原始色彩）
float[] identityMatrix = {1.0f, 0.0f, 0.0f,
                          0.0f, 1.0f, 0.0f,
                          0.0f, 0.0f, 1.0f};
captureRequest.set(CaptureRequest.CONTROL_COLOR_CORRECTION_MODE, CameraMetadata.CONTROL_COLOR_CORRECTION_MODE_TRANSFORM_MATRIX);
captureRequest.set(CaptureRequest.CONTROL_COLOR_CORRECTION_TRANSFORM, identityMatrix);
// 设置色彩增益，默认全1.0即可
captureRequest.set(CaptureRequest.CONTROL_COLOR_CORRECTION_GAINS, new float[]{1.0f, 1.0f, 1.0f, 1.0f});

// 3. （可选）关闭自动曝光，避免曝光变化影响色彩表现
captureRequest.set(CaptureRequest.CONTROL_AE_MODE, CameraMetadata.CONTROL_AE_MODE_OFF);
// 手动设置曝光时间和ISO，根据你的场景调整数值
captureRequest.set(CaptureRequest.SENSOR_EXPOSURE_TIME, 10_000_000L); // 10毫秒
captureRequest.set(CaptureRequest.SENSOR_SENSITIVITY, 100); // ISO 100
// -------------------------------------------------------------------------

// 添加预览Surface（你已有的持续捕获设置）
captureRequest.addTarget(previewSurface);

2. 考虑换用`TEMPLATE_PREVIEW`模板

如果你是做持续的图像流捕获（而非单张拍照），TEMPLATE_PREVIEW模板更适合——它默认就是为持续预览优化的，参数更稳定，后续手动覆盖色彩控制的逻辑和上面一致。

3. 兼容性检查

不同Android设备对Camera2 API的支持程度不同，建议在设置参数前先通过CameraCharacteristics查询设备是否支持对应的手动控制：

// 比如检查是否支持关闭AWB
CameraCharacteristics characteristics = cameraManager.getCameraCharacteristics(cameraId);
List<Integer> availableAwbModes = characteristics.get(CameraCharacteristics.CONTROL_AWB_AVAILABLE_MODES);
if (!availableAwbModes.contains(CameraMetadata.CONTROL_AWB_MODE_OFF)) {
    // 设备不支持手动关闭AWB，需要 fallback 到其他方案
}