Android 13 veya sonraki sürümlerin yüklü olduğu cihazlarda Android çerçevesi, el feneri gücü için çok seviyeli kontrol sağlar. Android 12 ve önceki sürümlerde çerçeve yalnızca el feneri modunun açılıp kapatılmasına izin verir. Çok seviyeli el feneri gücü kontrolünü destekleyerek cihazlar, aydınlatma koşullarına göre el fenerinin parlaklığını kontrol etme ve art arda hızlı ışık darbeleri göndererek flaş efektiyle yardım sinyalleri gönderme gibi kullanım alanlarını etkinleştirebilir. Bu özelliğin bir diğer avantajı da pil ömrünü ve performansı iyileştirebilmesidir. Çünkü termal kısıtlama koşullarına yol açabilecek şekilde el feneri modunun her zaman maksimum güçte açılması gerekmez.
Herkese açık API'ler
Uygulamalar, aşağıdaki herkese açık API'ler ve kamera özellikleri anahtarları aracılığıyla el feneri gücü kontrolü özelliğini kullanabilir. Kameraya erişilmediği için bu API'ler için kamera izni gerekmez.
CameraManager API'leri
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): El fenerinin parlaklık düzeyini, el feneri modunda verilencameraIddeğeriyle ilişkilendirerek ayarlar. El feneri modu kapalıysa vetorchStrengthdeğeri1değerine eşit veya daha büyükse el feneri,torchStrengthiçinde belirtilen güç seviyesinde açılır.public int getTorchStrengthLevel (String cameraId):cameraIdile ilişkili flaş biriminin parlaklık düzeyini döndürür.
CameraCharacteristics anahtarları
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Maksimum parlaklık seviyesi. Kamera HAL,1değerinden büyük bir değer ayarlayarak bu özelliğin reklamını yapar.FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Varsayılan el feneri parlaklık düzeyi.
Uygulama
Cihazınızda el feneri 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
HAL uygulamanızın, el feneri parlaklık kontrolü özelliğini desteklemek için aşağıdaki kamera özellikleri anahtarlarını duyurduğundan emin olun:
El feneri gücü kontrolünü destekleyen referans bir Kamera HAL uygulaması için
EmulatedCameraDeviceHWLImpl.cpp başlıklı makaleye bakın.
Doğrulama
El feneri gücü kontrolü özelliğini uygulamanızı doğrulamak için aşağıdaki VTS ve CTS testlerini çalıştırın: