Kontrola siły lampy

Na urządzeniach z Androidem 13 lub nowszym zapewnia wielopoziomową regulację siły pochodnej. W w Androidzie 12 i starszych wersjach platforma zezwala włączanie i wyłączanie trybu latarki. Przez obsługę wytrzymałości latarki wielopoziomowej urządzenia pozwalają na przykład sterować jasnością latarka w zależności od warunków oświetleniowych i wysyłanie sygnałów w celu uzyskania pomocy dzięki efektowi stroboskopowemu, wysyłając po kolei krótkie pulsacje światła. Inny Zaletą tej funkcji jest to, że może poprawić żywotność baterii i wydajność tryb latarki nie zawsze musi być włączony z maksymalną mocą, co może prowadzić do utrudnień termicznych.

Publiczne interfejsy API

Aplikacje mogą korzystać z funkcji kontroli siły latarki w następujących Interfejsy API i klucze charakterystyki kamery. Uprawnienia do korzystania z aparatu nie są wymagane w przypadku te interfejsy API, ponieważ nie mam dostępu do aparatu.

Interfejsy API CameraManager

• public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Ustawia poziom jasności latarki powiązanej z danym Wartość cameraId w trybie pochodnym. Jeśli tryb latarki jest wyłączony i torchStrength wynosi co najmniej 1, latarka włącza się z poziomem siły określono w funkcji torchStrength.
• public int getTorchStrengthLevel (String cameraId): Zwraca poziom jasności lampy błyskowej powiązanej z opcją cameraId.

Klawisze właściwości kamery

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Maksymalny poziom jasności. HAL aparatu reklamuje tę funkcję przez ustawienie wartość większą niż 1.
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Domyślny poziom jasności latarki.

Implementacja

Aby sterować siłą latarki na urządzeniu, użyj następujących narzędzi: Interfejsy AIDL HAL kamery:

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

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

Upewnij się, że implementacja HAL reklamuje te cechy aparatu klawiszy do obsługi funkcji regulacji jasności latarki:

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL

W celu uzyskania dodatkowych informacji o implementacji HAL aparatu wspierającej kontrolę siły latarki: zobacz EmulatedCameraDeviceHWLImpl.cpp

Weryfikacja

Aby sprawdzić poprawność implementacji funkcji kontroli siły pochodnej, uruchom następujące testy VTS i CTS:

• Konwersja wideo po wyświetleniu: /camera/provider/aidl/vts/VtsAidlHalCameraProvider\_TargetTest.cpp
• Punkt końcowy sprzedaży: /platform/cts/tests/camera/src/android/hardware/camera2/cts/FlashlightTest.java