Torç Gücü Kontrolü

Android 13 veya üstünü çalıştıran cihazlar için Android çerçevesi, torç gücü için çok düzeyli bir kontrol sağlar. Android 12 ve önceki sürümlerde çerçeve yalnızca fener modunun açılmasına veya kapatılmasına izin verir. Cihazlar, çok seviyeli torç gücü kontrolünü destekleyerek, aydınlatma koşullarına göre el fenerinin parlaklığını kontrol etme ve arka arkaya hızlı ışık darbeleri göndererek flaş efekti kullanarak yardım için sinyaller gönderme gibi kullanım durumlarını mümkün kılabilir. Bu özelliğin bir diğer faydası da, fener modunun her zaman maksimum güçte açılmasına gerek olmadığından pil ömrünü ve performansını iyileştirebilmesidir, bu da termal kısıtlama koşullarına yol açabilir.

Genel API'ler

Uygulamalar, aşağıdaki genel API'ler ve kamera özellikleri tuşları aracılığıyla fener gücü kontrol özelliğini kullanabilir. Kameraya erişilemediği için bu API'ler için kamera izni gerekmez.

CameraManager API'leri

• public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength) : El feneri modunda verilen cameraId değeriyle ilişkili el fenerinin parlaklık düzeyini ayarlar. Torç modu kapalıysa ve torchStrength 1 büyük veya ona eşitse, torç torchStrength öğesinde belirtilen güç düzeyiyle açılır.
• public int getTorchStrengthLevel (String cameraId) : cameraId ile ilişkili flaş ünitesinin parlaklık düzeyini döndürür.

CameraCharacteristics tuşları

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL : Maksimum parlaklık düzeyi. Kamera HAL'si bu özelliği 1 büyük bir değer ayarlayarak tanıtır.
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL : Varsayılan el feneri parlaklık düzeyi.

Uygulama

Cihazınızdaki torç gücü kontrolü özelliğini desteklemek için aşağıdaki kamera AIDL HAL arayüzlerini kullanın:

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

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

HAL uygulamanızın, fener parlaklık kontrolü özelliğini desteklemek için aşağıdaki kamera özellikleri anahtarlarını tanıttığından emin olun:

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL

Torç gücü kontrolünü destekleyen referans Kamera HAL uygulaması için bkz. EmulatedCameraDeviceHWLImpl.cpp .

Doğrulama

Torç gücü kontrolü özelliğini uyguladığınızı doğrulamak için aşağıdaki VTS ve CTS testlerini çalıştırın:

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