Control de la potencia de la linterna

En dispositivos que ejecutan Android 13 o versiones posteriores, el framework de Android proporciona un control de varios niveles para la potencia de la linterna. En Android 12 y versiones anteriores, el framework solo permite activar o desactivar el modo de linterna. Con la compatibilidad con el control de intensidad de la linterna de varios niveles, los dispositivos pueden habilitar casos de uso, como controlar el brillo de la linterna según las condiciones de iluminación y enviar señales de asistencia con un efecto estroboscópico mediante el envío de pulsos de luz rápidos en una fila. Otro beneficio de esta función es que puede mejorar la duración de batería y el rendimiento, ya que no siempre es necesario que el modo de linterna se active con la intensidad máxima, lo que puede generar condiciones de limitación térmica.

APIs públicas

Las apps pueden usar la función de control de intensidad de la linterna a través de las siguientes APIs públicas y claves de características de la cámara. No se requieren permisos de cámara para estas APIs porque no se accede a la cámara.

APIs de CameraManager

• public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Establece el nivel de brillo de la linterna asociado con el valor cameraId determinado en el modo de linterna. Si el modo de linterna está desactivado y torchStrength es mayor o igual que 1, la linterna se enciende con el nivel de intensidad especificado en torchStrength.
• public int getTorchStrengthLevel (String cameraId): Muestra el nivel de brillo de la unidad de flash asociada con cameraId.

Claves de CameraCharacteristics

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Máxima intensidad de brillo. El HAL de la cámara anuncia esta función configurando un valor superior a 1.
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Es el nivel de brillo predeterminado de la linterna.

Implementación

Para admitir la función de control de intensidad de la linterna en tu dispositivo, usa las siguientes interfaces de la HAL de la cámara de AIDL:

Ubicación: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl

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

Asegúrate de que tu implementación de HAL anuncie las siguientes claves de características de la cámara para admitir la función de control de brillo de la linterna:

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL

Para obtener una implementación de referencia de la HAL de la cámara que admita el control de la potencia de la linterna, consulta EmulatedCameraDeviceHWLImpl.cpp.

Validación

Para validar la implementación de la función de control de intensidad de la linterna, ejecuta las siguientes pruebas de VTS y CTS:

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