android.hardware.camera.flash 无法正常触发闪光灯

Question

在使用 `android.hardware.camera` 时，调用闪光灯功能常出现无法正常触发的问题。典型表现为：尽管已正确获取相机实例并设置闪光灯模式为 `FLASH_MODE_TORCH`，但物理闪光灯无响应。该问题多见于部分厂商定制 ROM（如小米、华为）对硬件权限的限制或相机资源未及时释放。此外，未在 `AndroidManifest.xml` 中声明 `CAMERA` 和 `FLASHLIGHT` 权限，或未通过 `hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH)` 检测闪光灯支持情况，也会导致控制失败。需注意，Android 5.0（API 21）以上推荐使用 `CameraManager` 配合 `TurnOnTorch()` 方法替代旧版 Camera API，以提升兼容性与稳定性。

Answer 1

1. 问题背景与现象描述

在使用 android.hardware.camera 接口控制设备闪光灯时，开发者常遇到“设置闪光灯模式为 FLASH_MODE_TORCH 后，物理闪光灯无响应”的问题。该问题并非普遍存在于所有 Android 设备，但在小米、华为、OPPO 等厂商的定制 ROM 上尤为突出。

典型表现包括：

• 相机实例已成功打开
• 参数设置中明确设置了 parameters.setFlashMode(Camera.Parameters.FLASH_MODE_TORCH)
• parameters 被重新应用（camera.setParameters(parameters)）
• 但设备闪光灯未点亮，且无异常日志输出

2. 常见原因分析

从权限、系统特性检测到 API 使用方式，多个层面可能导致闪光灯调用失败。以下是常见成因的结构化梳理：

类别	具体原因	影响范围
权限缺失	未声明 CAMERA 或 FLASHLIGHT 权限	全版本通用
硬件支持	设备无闪光灯或未通过 FEATURE_CAMERA_FLASH 检测	低端或虚拟设备
API 过时	使用废弃的 Camera API 而非 CameraManager	Android 5.0+
资源冲突	相机被其他应用或服务占用	厂商 ROM 特有
厂商限制	MIUI、EMUI 对闪光灯开启添加额外校验	小米、华为设备

3. 解决方案演进路径

随着 Android 系统迭代，闪光灯控制的最佳实践也在不断演进。以下是从旧到新的三种主流实现方式：

1. Legacy Camera API（已废弃）

   Camera camera = Camera.open();
   Camera.Parameters params = camera.getParameters();
   params.setFlashMode(Camera.Parameters.FLASH_MODE_TORCH);
   camera.setParameters(params);
   camera.startPreview(); // 必须调用，否则不生效
   

2. CameraManager + Torch（推荐，API 21+）

   CameraManager manager = (CameraManager) context.getSystemService(Context.CAMERA_SERVICE);
   String cameraId = manager.getCameraIdList()[0];
   manager.setTorchMode(cameraId, true);
   

3. 兼容性封装：结合运行时判断

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
       // 使用 CameraManager
   } else {
       // 回退至 Camera API
   }
   

4. 完整检测与调用流程图

graph TD A[开始] --> B{是否有FLASHLIGHT权限?} B -- 否 --> C[请求权限] B -- 是 --> D{支持FEATURE_CAMERA_FLASH?} D -- 否 --> E[提示设备不支持] D -- 是 --> F{API >= 23?} F -- 是 --> G[使用CameraManager.setTorchMode] F -- 否 --> H[使用Camera API 设置FLASH_MODE_TORCH] G --> I[监听ResultCallback处理异常] H --> J[确保startPreview并捕获Runtime异常] I --> K[结束] J --> K

5. 实际开发中的关键代码示例

以下是一个兼顾兼容性与健壮性的闪光灯控制类核心片段：

public class FlashlightController {
    private CameraManager cameraManager;
    private String cameraId;
    private boolean isTorchOn;

    @RequiresApi(api = Build.VERSION_CODES.M)
    public void turnOn() throws Exception {
        if (cameraManager == null) {
            cameraManager = (CameraManager) context.getSystemService(Context.CAMERA_SERVICE);
            cameraId = cameraManager.getCameraIdList()[0];
        }
        cameraManager.setTorchMode(cameraId, true);
        isTorchOn = true;
    }

    public boolean isFlashlightSupported() {
        return context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH);
    }

    public void release() {
        if (cameraManager != null && cameraId != null) {
            try {
                cameraManager.setTorchMode(cameraId, false);
            } catch (Exception e) {
                Log.e("Flashlight", "Failed to turn off torch", e);
            }
        }
    }
}

6. 厂商适配策略建议

针对不同厂商 ROM 的行为差异，建议采取如下策略：

• 对于小米设备：部分 MIUI 版本需在后台保持 Activity 或使用前台 Service 才能维持闪光灯常亮
• 华为 EMUI：某些版本在锁屏状态下会强制关闭闪光灯，需注册 SCREEN_OFF 广播监听并重新开启
• OPPO/realme：ColorOS 对长时间开启闪光灯进行功耗限制，建议加入定时重启机制
• 三星：Galaxy 系列对 CameraManager 支持良好，优先使用新 API

可通过 Build.MANUFACTURER 进行差异化处理，例如：

if ("xiaomi".equalsIgnoreCase(Build.MANUFACTURER)) {
    // 小米特殊处理逻辑
}