手電筒強度控制

對於搭載 Android 13 以上版本的裝置,Android 架構會提供多層級手電筒亮度控制選項。在 Android 12 以下版本中,架構只允許開啟或關閉手電筒模式。透過支援多層手電筒強度控制,裝置可啟用多種用途,例如根據光線條件控制手電筒的亮度,以及透過連續發送快速脈衝光線,使用閃爍效果傳送信號。這項功能的另一個好處是,它可以改善電池續航力和效能,因為手電筒模式不必一律以最大強度開啟,否則可能會導致熱力節流。

公用 API

應用程式可以透過下列公開 API 和相機特性鍵使用手電筒亮度控制功能。這些 API 不需要相機權限,因為系統不會存取相機。

CameraManager API

CameraCharacteristics 鍵

實作

如要在裝置上支援手電筒強度控制功能,請使用下列相機 AIDL HAL 介面:

位置:/camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl

請確認 HAL 實作項目會宣告下列相機特性鍵,以支援手電筒亮度控制功能:

如需支援手電筒亮度控制功能的參考相機 HAL 實作方式,請參閱 EmulatedCameraDeviceHWLImpl.cpp

驗證

如要驗證手電筒強度控制功能的實作方式,請執行下列 VTS 和 CTS 測試: