Accede al sensor de luz ambiental para medir niveles de iluminancia en lux en tiempo real
Empieza con isAvailable() y los demás métodos principales detallados abajo.
Soporte de plataformas
Sección titulada “Soporte de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | Nativo |
| Android | Sí | Nativo |
| Web | No | Protege con Capacitor.getPlatform() |
Funcionalidades principales
Sección titulada “Funcionalidades principales”isAvailable- Comprueba si el sensor de luz está disponible en el dispositivo actual. Siempre debes verificar la disponibilidad del sensor antes de intentar usarlo.start- Empieza a escuchar las actualizaciones del sensor de luz. Esto iniciará las mediciones en el intervalo especificado. UsaaddListenerpara recibir los datos del sensor.stop- Deja de escuchar las actualizaciones del sensor de luz. Esto detendrá el sensor y ahorrará batería.checkPermissions- Comprueba el estado del permiso para sensores de alta frecuencia de muestreo. En Android 12+, se requiere el permiso HIGH_SAMPLING_RATE_SENSORS para intervalos de actualización inferiores a 200ms.
Público API
Sección titulada “Público API”| Método | Descripción |
|---|---|
isAvailable | Comprueba si el sensor de luz está disponible en el dispositivo actual. Siempre debes verificar la disponibilidad del sensor antes de intentar usarlo. |
start | Empieza a escuchar las actualizaciones del sensor de luz. Esto iniciará las mediciones del sensor en el intervalo especificado. Usa addListener para recibir los datos del sensor. |
stop | Deja de escuchar las actualizaciones del sensor de luz. Esto detendrá el sensor y ahorrará batería. |
addListener | Añade un listener para los eventos de cambio del sensor de luz. El listener se ejecutará cada vez que haya nuevos datos del sensor disponibles. |
removeAllListeners | Elimina todos los listeners de los eventos del sensor de luz. |
checkPermissions | Consulta el estado actual de los permisos para sensores de alta frecuencia de muestreo. En Android 12+, se requiere el permiso HIGH_SAMPLING_RATE_SENSORS para intervalos de actualización inferiores a 200ms. |
requestPermissions | Solicita permiso para sensores de alta frecuencia de muestreo. En Android 12+, esto solicita el permiso HIGH_SAMPLING_RATE_SENSORS. |
getPluginVersion | Obtén la versión actual del plugin. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-light-sensor.
Continúa con @capgo/capacitor-light-sensor
Sección titulada “Continúa con @capgo/capacitor-light-sensor”Si estás usando @capgo/capacitor-light-sensor para planificar las operaciones del dashboard y de API, conéctalo con Uso de @capgo/capacitor-light-sensor para la funcionalidad nativa en Uso de @capgo/capacitor-light-sensor, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para los detalles de implementación en las claves de API, y Dispositivos para el detalle de implementación en Devices.