En el caso de los 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 multinivel, 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 enviando pulsos rápidos de luz seguidos. Otro beneficio de esta función es que puede mejorar la duración de batería y el rendimiento, ya que el modo de linterna no siempre necesita estar encendido con la máxima intensidad, lo que puede generar condiciones de estrangulamiento térmico.
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 la 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 asociada al valor decameraIddeterminado en el modo de linterna. Si el modo de linterna está desactivado ytorchStrengthes mayor o igual que1, la linterna se enciende con el nivel de intensidad especificado entorchStrength.public int getTorchStrengthLevel (String cameraId): Devuelve el nivel de brillo de la unidad de flash asociada concameraId.
Claves de CameraCharacteristics
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Es el nivel de brillo máximo. La HAL de la cámara anuncia esta función estableciendo un valor mayor que1.FLASH_INFO_STRENGTH_DEFAULT_LEVEL: 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 HAL de la cámara del AIDL:
Ubicación: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
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:
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: