Flaş Gücü Kontrolü

Android 13 veya sonraki sürümleri çalıştıran cihazlarda Android çerçeve, fener gücü için çok düzeyli bir kontrol sağlar. İçinde Android 12 ve önceki sürümlerde çerçeve flaş modunu açar veya kapatır. Çok seviyeli flaşın gücünü destekleyerek parlaklığını kontrol etmek gibi kullanım alanlarına olanak tanıdığından ışıklandırma koşullarına ve yardım sinyallerine dayalı el feneri art arda hızlı ışık atımları göndererek flaş efekti kullanıyor. Diğer faydası, pil ömrünü ve performansını artırabildiği için fener modunun her zaman maksimum güçte açılması gerekmez. Bu da termal kısıtlama koşullarına yol açabilir.

Herkese Açık API'ler

Uygulamalar, fener gücü kontrolü özelliğini aşağıdaki herkese açık API'ler ve kamera özelliği tuşları. Şunlar için kamera izni gerekmez: bu API'leri kullanabilirsiniz.

CameraManager API

• public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Belirtilen el fenerinin parlaklık seviyesini, Flaş modunda cameraId değer. Flaş modu kapalıysa ve torchStrength 1 değerinden büyük veya eşitse fener, güç seviyesiyle açılır torchStrength içinde belirtilir.
• public int getTorchStrengthLevel (String cameraId): cameraId ile ilişkili flash biriminin parlaklık düzeyini döndürür.

CameraCharacteristics anahtar

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Maksimum parlaklık düzeyi. Kamera HAL'si, bu özelliğin reklamını yapmak için 1 değerinden büyük bir değere
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Varsayılan el feneri parlaklık düzeyi.

Uygulama

Cihazınızda fener gücü kontrolü özelliğini desteklemek için aşağıdakileri kullanın: kamera AIDL HAL arayüzleri:

Konum: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl

• void turnOnTorchWithStrengthLevel(int torchStrength)
• int getTorchStrengthLevel()

HAL uygulamanızda aşağıdaki kamera özelliklerinin gösterildiğinden emin olun fener parlaklık kontrolü özelliğini destekleyen tuşlar:

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL

Flaş gücü kontrolünü destekleyen kamera HAL uygulaması için bkz. EmulatedCameraDeviceHWLImpl.cpp.

Doğrulama

Flaş gücü kontrol özelliğini uygulamanızı doğrulamak için aşağıdaki VTS ve CTS testlerini takip edin:

• VTS: /camera/provider/aidl/vts/VtsAidlHalCameraProvider\_TargetTest.cpp
• CTS: /platform/cts/tests/camera/src/android/hardware/camera2/cts/FlashlightTest.java