Sensor de luz plugin Capacitor

Uso de @capgo/capacitor-light-sensor

Plugin Capacitor para acceder al sensor de luz ambiental del dispositivo.

Instalar

bun add @capgo/capacitor-light-sensor
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

import { LightSensor } from '@capgo/capacitor-light-sensor';

API de un vistazo

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 recibir 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.
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.

Ejemplos

isAvailable()

Comprueba si el sensor de luz está disponible en el dispositivo actual. Siempre debes verificar la disponibilidad del sensor antes de intentar usarlo.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const { available } = await LightSensor.isAvailable();

start()

Empieza a recibir actualizaciones del sensor de luz. Esto iniciará las mediciones del sensor en el intervalo especificado. Usa addListener para recibir los datos del sensor.

import { LightSensor } from '@capgo/capacitor-light-sensor';

await LightSensor.start({ updateInterval: 500 });

stop()

Deja de escuchar las actualizaciones del sensor de luz. Esto detendrá el sensor y ahorrará batería.

import { LightSensor } from '@capgo/capacitor-light-sensor';

await LightSensor.stop();

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.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const status = await LightSensor.checkPermissions();

requestPermissions()

Solicita permiso para sensores de alta frecuencia de muestreo. En Android 12+, esto solicita el permiso HIGH_SAMPLING_RATE_SENSORS.

import { LightSensor } from '@capgo/capacitor-light-sensor';

const status = await LightSensor.requestPermissions();

Escuchar eventos

addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonte, o LightSensor.removeAllListeners() para limpiar todos los listeners.

Referencia completa

• repositorio GitHub
• Documentación
• Referencia de API

Continúa desde Uso de @capgo/capacitor-light-sensor

Si estás usando Uso de @capgo/capacitor-light-sensor para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-light-sensor para los detalles de implementación en @capgo/capacitor-light-sensor, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.