Android端如何通过编程方式调节手电筒亮度高低

Android平台可以通过编程方式调节手电筒亮度，但不存在全系统版本通用的稳定方案，不同版本的实现逻辑差异很大：

• Android 13（API 级别33）及以上版本：这是目前唯一官方支持、兼容性最稳定的适配方案。系统公开了手电筒亮度调节的标准API，不需要依赖厂商私有接口，也不需要反射调用。
  实现核心是通过CameraManager类操作：首先先获取对应带闪光灯的摄像头ID，查询设备支持的最大手电筒亮度等级，再传入目标亮度值即可完成调节。注意如果查询到的最大亮度值为1，说明该设备仅支持手电筒开关，不支持亮度调节。
  核心实现代码参考（Kotlin）：

  val cameraManager = getSystemService(Context.CAMERA_SERVICE) as CameraManager
  // 实际开发中建议遍历cameraManager.cameraIdList，匹配后置带闪光灯的摄像头ID，不要硬编码"0"
  val backCameraId = "0"
  // 查询设备支持的最大手电筒亮度
  val maxTorchLevel = cameraManager.getCameraCharacteristics(backCameraId)
      .get(CameraCharacteristics.FLASH_INFO_STRENGTH_MAXIMUM_LEVEL) ?: 1
  
  if (maxTorchLevel > 1) {
      // 设备支持亮度调节，例如设置为最大亮度的50%
      val targetLevel = (maxTorchLevel * 0.5).toInt().coerceIn(1, maxTorchLevel)
      cameraManager.turnOnTorchWithStrengthLevel(backCameraId, targetLevel)
  } else {
      // 设备不支持亮度调节，仅执行普通开启逻辑
      cameraManager.setTorchMode(backCameraId, true)
  }
  

• Android 12（API31）、Android 12L（API32）：这两个版本的系统源码里已经存在上述亮度调节方法，但属于隐藏API，普通第三方应用直接调用会被系统的隐藏API限制拦截，通过反射等黑科技方式调用稳定性极差，很容易在不同厂商的定制系统上出现崩溃、功能失效问题，不建议普通应用做适配。
• Android 11（API30）及更低版本：系统层完全没有提供标准的亮度调节API，仅少数厂商在自己的定制系统里预留了私有SDK接口，没有统一适配标准，接口随时可能随系统更新失效，适配成本极高，没有通用的可行方案，这些版本下基本只能实现手电筒的开关控制。

适配注意事项 #

• 必须在AndroidManifest.xml中声明必要的权限与硬件特性声明：

  <uses-permission android:name="android.permission.CAMERA" />
  <uses-feature android:name="android.hardware.camera.flash" android:required="false" />
  

  Android 6.0及以上版本需要在运行时动态申请相机权限，未获得权限时调用闪光灯相关接口会抛出安全异常。
• 不要硬编码亮度值：不同机型支持的最大亮度区间差异很大，部分机型最大值为10，部分机型为100，必须先读取设备的最大亮度值再按比例计算目标亮度。
• 不要只在原生模拟器上测试功能，部分厂商虽然搭载了Android13及以上版本，但可能会自行修改系统逻辑屏蔽亮度调节接口，必须覆盖主流品牌真机做兼容性测试。
• 应用退出、页面销毁时要及时关闭手电筒，避免长期占用相机资源导致其他应用无法正常调用相机。

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