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 verilencameraId
değeriyle ilişkili el fenerinin parlaklık düzeyini ayarlar. Torç modu kapalıysa vetorchStrength
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ği1
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
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:
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
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 verilencameraId
değeriyle ilişkili el fenerinin parlaklık düzeyini ayarlar. Torç modu kapalıysa vetorchStrength
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ği1
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
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:
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