使用Camera2 API拍摄静态图片时无法触发闪光灯问题求助

问题概述 #

使用Camera2 API拍摄时，设置CONTROL_AE_MODE_ON_ALWAYS_FLASH或CONTROL_AE_MODE_ON_AUTO_FLASH均无法触发闪光灯。已为静态捕捉（TEMPLATE_STILL_CAPTURE）和预览（TEMPLATE_PREVIEW）的请求构建器配置对应参数，代码示例如下：

val captureRequestBuilder = cameraDevice
            .createCaptureRequest(AndroidCameraDevice.TEMPLATE_STILL_CAPTURE)
 
captureRequestBuilder.apply {
set(CaptureRequest.CONTROL_AE_MODE,
     CaptureRequest.CONTROL_AE_MODE_ON_ALWAYS_FLASH)
}

查阅相关资源（Google相机示例、已归档的Camera2基础Demo、技术论坛回答、Android官方文档）后仍未解决，疑问：是否必须经过预捕获阶段才能触发闪光灯？

关键结论与实现步骤 #

1. 预捕获阶段是必要的 #

对于CONTROL_AE_MODE_ON_AUTO_FLASH和CONTROL_AE_MODE_ON_ALWAYS_FLASH模式，必须执行预捕获序列才能触发闪光灯。Camera2的自动曝光（AE）系统需要通过预捕获完成测光、对焦及闪光灯准备，跳过此步骤会导致闪光灯无响应。

2. 正确实现流程 #

• 前置检查：通过CameraCharacteristics.FLASH_INFO_AVAILABLE确认设备支持闪光灯。
• 预览阶段配置：将预览请求的CONTROL_AE_MODE设为目标闪光灯模式，维持AE系统的基础状态。
• 拍照触发流程：
  • 创建预捕获请求，设置CONTROL_AE_PRECAPTURE_TRIGGER为CONTROL_AE_PRECAPTURE_TRIGGER_START并发送。
  • 监听CaptureResult.CONTROL_AE_STATE，当状态变为CONTROL_AE_STATE_CONVERGED或CONTROL_AE_STATE_LOCKED时，发送静态捕捉请求（TEMPLATE_STILL_CAPTURE），此时闪光灯会按设定模式触发。
  • 拍照完成后，将CONTROL_AE_PRECAPTURE_TRIGGER设为CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL，恢复预览的AE状态。

3. 常见问题排查 #

• 未等待AE状态收敛：直接发送静态捕获请求会导致AE系统未完成准备，闪光灯不触发。
• 权限缺失：确保已申请CAMERA权限，Android 10及以上需额外申请FLASHlight权限。
• 设备兼容性：部分低端设备的Camera2 API实现存在兼容问题，可切换至LEGACY级别测试。

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