Contrôle de la force de la torche

Pour les appareils exécutant Android 13 ou version ultérieure, le framework Android fournit un contrôle à plusieurs niveaux de la force de la torche. Sous Android 12 et versions antérieures, le framework permet uniquement d'activer ou de désactiver le mode torche. En prenant en charge le contrôle de la force de la torche à plusieurs niveaux, les appareils peuvent permettre des cas d'utilisation tels que le contrôle de la luminosité de la lampe de poche en fonction des conditions d'éclairage et l'envoi de signaux d'assistance à l'aide d'un effet stroboscopique en envoyant des impulsions lumineuses rapides d'affilée. Un autre avantage de cette fonctionnalité est qu'elle peut améliorer la durée de vie et les performances de la batterie, car le mode torche n'a pas toujours besoin d'être activé à la puissance maximale, ce qui peut entraîner des conditions de limitation thermique.

API publiques

Les applications peuvent utiliser la fonction de contrôle de la force de la torche via les API publiques et les clés de caractéristiques de la caméra suivantes. Aucune autorisation de caméra n'est requise pour ces API, car la caméra n'est pas accessible.

API CameraManager

CameraCharacteristics caractéristiques

Mise en œuvre

Pour prendre en charge la fonction de contrôle de la puissance de la torche sur votre appareil, utilisez les interfaces AIDL HAL de la caméra suivantes :

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

Assurez-vous que votre implémentation HAL annonce les clés de caractéristiques de caméra suivantes pour prendre en charge la fonction de contrôle de la luminosité de la torche :

Pour une implémentation de référence de Camera HAL prenant en charge le contrôle de la force de la torche, voir EmulatedCameraDeviceHWLImpl.cpp .

Validation

Pour valider votre implémentation de la fonction de contrôle de la force de la torche, exécutez les tests VTS et CTS suivants :

,

Pour les appareils exécutant Android 13 ou version ultérieure, le framework Android fournit un contrôle à plusieurs niveaux de la force de la torche. Sous Android 12 et versions antérieures, le framework permet uniquement d'activer ou de désactiver le mode torche. En prenant en charge le contrôle de la force de la torche à plusieurs niveaux, les appareils peuvent permettre des cas d'utilisation tels que le contrôle de la luminosité de la lampe de poche en fonction des conditions d'éclairage et l'envoi de signaux d'assistance à l'aide d'un effet stroboscopique en envoyant des impulsions lumineuses rapides d'affilée. Un autre avantage de cette fonctionnalité est qu'elle peut améliorer la durée de vie et les performances de la batterie, car le mode torche n'a pas toujours besoin d'être activé à la puissance maximale, ce qui peut entraîner des conditions de limitation thermique.

API publiques

Les applications peuvent utiliser la fonction de contrôle de la force de la torche via les API publiques et les clés de caractéristiques de la caméra suivantes. Aucune autorisation de caméra n'est requise pour ces API, car la caméra n'est pas accessible.

API CameraManager

CameraCharacteristics caractéristiques

Mise en œuvre

Pour prendre en charge la fonction de contrôle de la puissance de la torche sur votre appareil, utilisez les interfaces AIDL HAL de la caméra suivantes :

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

Assurez-vous que votre implémentation HAL annonce les clés de caractéristiques de caméra suivantes pour prendre en charge la fonction de contrôle de la luminosité de la torche :

Pour une implémentation de référence de Camera HAL prenant en charge le contrôle de la force de la torche, voir EmulatedCameraDeviceHWLImpl.cpp .

Validation

Pour valider votre implémentation de la fonction de contrôle de la force de la torche, exécutez les tests VTS et CTS suivants :