Steuerung der Taschenlampenleistung

Auf Geräten mit Android 13 oder höher bietet das Android-Framework eine mehrstufige Steuerung der Taschenlampenleistung. Unter Android 12 und niedriger ermöglicht das Framework nur das Ein- und Ausschalten des Taschenlampenmodus. Durch die Unterstützung einer mehrstufigen Steuerung der Taschenlampenstärke können Geräte Anwendungsfälle wie die Steuerung der Helligkeit der Taschenlampe basierend auf den Lichtverhältnissen und das Senden von Hilfesignalen mit einem Stroboskopeffekt ermöglichen, indem schnelle Lichtimpulse hintereinander gesendet werden. Ein weiterer Vorteil dieser Funktion ist, dass sich die Akkulaufzeit und Leistung verbessern können, da der Taschenlampenmodus nicht immer mit maximaler Stärke aktiviert werden muss, was zu einer thermischen Drosselung führen kann.

Öffentliche APIs

Apps können die Funktion zur Steuerung der Taschenlampenleistung über die folgenden öffentlichen APIs und Schlüssel für Kameramerkmale verwenden. Für diese APIs sind keine Kameraberechtigungen erforderlich, da kein Zugriff auf die Kamera erfolgt.

CameraManager APIs

• public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Mit diesem Befehl wird die Helligkeit der Taschenlampe im Taschenlampenmodus festgelegt, die dem angegebenen cameraId-Wert zugeordnet ist. Wenn der Taschenlampenmodus deaktiviert ist und torchStrength größer oder gleich 1 ist, wird die Taschenlampe mit der in torchStrength angegebenen Stärke eingeschaltet.
• public int getTorchStrengthLevel (String cameraId): Gibt die Helligkeit des mit cameraId verknüpften Blitzes zurück.

Schlüssel für „CameraCharacteristics“

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Maximale Helligkeit. Die Kamera-HAL kündigt diese Funktion an, indem ein Wert festgelegt wird, der über 1 liegt.
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Standardhelligkeit der Taschenlampe.

Implementierung

Verwenden Sie die folgenden Kamera-AIDL-HAL-Schnittstellen, um die Funktion zur Steuerung der Taschenlampenstärke auf Ihrem Gerät zu unterstützen:

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

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

Ihre HAL-Implementierung muss die folgenden Kameraeigenschaften angeben, um die Funktion zur Steuerung der Taschenlampenhelligkeit zu unterstützen:

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL

Eine Referenzimplementierung der Kamera-HAL, die die Steuerung der Taschenlampenstärke unterstützt, finden Sie unter EmulatedCameraDeviceHWLImpl.cpp.

Zertifizierungsstufe

Führen Sie die folgenden VTS- und CTS-Tests aus, um die Implementierung der Funktion zur Steuerung der Taschenlampenhelligkeit zu validieren:

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