Camera2 API 闪光灯模式详解：从参数配置到拍照流程

最新推荐文章于 2026-04-19 09:34:09 发布

原创

最新推荐文章于 2026-04-19 09:34:09 发布 · 433 阅读

1. 闪光灯模式：不只是“开”和“关”那么简单

很多刚开始接触Camera2 API的开发者，一看到闪光灯模式，可能觉得这不就是“开”、“关”、“自动”和“手电筒”嘛，手机上早就用烂了。我以前也是这么想的，直到真正在项目里集成拍照功能，被各种奇怪的闪或不闪的bug折腾得够呛，才发现这里面的水可深了。Camera2 API把相机控制权下放给了开发者，闪光灯也不例外，它不再是系统相机App里一个简单的开关，而是一系列需要你精确协调的参数和状态机。如果你只是简单地把FLASH_MODE设成ON，然后指望按下快门就一定能亮，那大概率会失望，尤其是在一些中低端或者定制化比较深的设备上。

简单来说，Camera2 API中的闪光灯行为，是由两个核心参数共同决定的：闪光灯模式（Flash Mode） 和自动曝光模式（AE Mode）。你可以把它们想象成一场双人舞，一个负责决定“要不要跳”（Flash Mode），另一个负责判断“现在是不是跳舞的好时机”（AE Mode）。只有当两者达成一致，闪光灯才会在正确的时机亮起。我们常说的AUTO、OFF、ON、TORCH，就是Flash Mode的四种状态。但很多人会忽略，当你设置不同的Flash Mode时，Camera2框架内部会自动帮你设置一个对应的AE Mode，或者要求你手动设置一个匹配的AE Mode，否则流程就走不通。

举个例子，你设Flash Mode为ON，意思是“我不管环境亮暗，拍照时你必须给我闪”。但相机系统在执行前，还得问问负责曝光计算的AE模块：“老兄，我现在要强制闪了，你那边状态OK吗？”这时候，AE模块就必须处于一个“我准备好应对强制闪光”的状态，这个状态通常就是AE_MODE_ON_ALWAYS_FLASH。如果你没把这个对应关系理清，拍照请求发出去，闪光灯可能没反应，或者照片曝光一塌糊涂。所以，理解闪光灯，第一步就是抛弃“单一开关”的思维，建立起“模式组合”的概念。

2. 四大模式深度拆解与参数配置

2.1 AUTO模式：把决定权交给环境

FLASH_MODE_AUTO是最常用，但也最容易被误解的模式。你以为设成AUTO，相机就会智能判断该不该闪？没错，但“智能判断”的依据是什么，怎么工作的，这就需要我们开发者心里有数。

在AUTO模式下，拍照时是否触发闪光，完全取决于相机自动曝光（AE）模块的评估。AE模块会持续分析预览画面的亮度（通过lux_index等光感数据）。当它认为环境光太暗，不足以让当前曝光参数拍出清晰照片时，就会进入一个FLASH_REQUIRED的状态。关键点来了：只有AE模块处于FLASH_REQUIRED状态时，你发起的拍照（Capture）请求，才会触发一次闪光。这个闪光模式是FLASH_MODE_SINGLE（单次闪光）。

在代码配置上，当你设置Flash Mode为AUTO时，通常需要将AE_MODE设置为AE_MODE_ON_AUTO_FLASH。这个模式告诉AE：“你正常工作，自动测光，但如果觉得太暗需要闪光，就告诉我，我会配合触发。” 具体到CaptureRequest的构建，大概是这样的：

CaptureRequest.Builder previewBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
previewBuilder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH);
previewBuilder.set(CaptureRequest.FLASH_MODE, CaptureRequest.FLASH_MODE_AUTO);
// ... 其他预览参数
previewSession.setRepeatingRequest(previewBuilder.build(), ...);

// 拍照时，使用同样的AE和Flash模式，或者直接使用TEMPLATE_STILL_CAPTURE模板
CaptureRequest.Builder captureBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE);
captureBuilder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH);
captureBuilder.set(CaptureRequest.FLASH_MODE, CaptureRequest.FLASH_MODE_AUTO);
// 添加输出Surface等
previewSession.capture(captureBuilder.build(), ...);

这里有个坑我踩过：有些设备对AE_MODE_ON_AUTO_FLASH的支持有差异。在预览时，即使环境很暗，AE状态可能也不会立即变成FLASH_REQUIRED，而是需要一点收敛时间。所以，如果你在预览刚一启动、光线很暗时就立刻拍照，闪光灯可能不会触发。稳妥的做法是，监听AE状态回调（Capt

标签