Guía
Cómo usar el sensor de luz en Capacitor
Usando @capgo/capacitor-sensor-de-luz
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 código nativo del plugin code en tus proyectos nativos. Ejecútalo de nuevo después de cada actualización del plugin.
Importar
import { LightSensor } from '@capgo/capacitor-light-sensor';
Vista general de API
| Método | Descripción |
|---|---|
isAvailable |
Verifique si el sensor de luz está disponible en el dispositivo actual. Siempre debe verificar la disponibilidad del sensor antes de intentar utilizarlo. |
start |
Comience a escuchar actualizaciones del sensor de luz. Esto comenzará las mediciones del sensor con el intervalo especificado. Use addListener para recibir los datos del sensor. |
stop |
Detenga la escucha de actualizaciones del sensor de luz. Esto detendrá el sensor y conservará la batería. |
checkPermissions |
Verifique el estado de permiso actual para sensores de alta frecuencia de muestreo. En Android 12+, se requiere la permiso de sensores de alta frecuencia de muestreo para intervalos de actualización del sensor debajo de 200ms. |
requestPermissions |
Solicite permiso para sensores de alta frecuencia de muestreo. En Android 12+, esto solicita la permiso de HIGH_SAMPLING_RATE_SENSORS. |
Ejemplos
isAvailable()
Verifique si el sensor de luz está disponible en el dispositivo actual. Siempre debe verificar la disponibilidad del sensor antes de intentar utilizarlo.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const { available } = await LightSensor.isAvailable();
start()
Comience a escuchar actualizaciones del sensor de luz. Esto comenzará las mediciones del sensor con el intervalo especificado. Use addListener para recibir los datos del sensor.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.start({ updateInterval: 500 });
stop()
Detenga la escucha de actualizaciones del sensor de luz. Esto detendrá el sensor y conservará la batería.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.stop();
checkPermissions()
Verifique el estado de permiso actual para sensores de alta frecuencia de muestreo. En Android 12+, se requiere la permiso de sensores de alta frecuencia de muestreo para intervalos de actualización del sensor debajo de 200ms.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.checkPermissions();
requestPermissions()
Solicite permiso para sensores de alta frecuencia de muestreo. En Android 12+, esto solicita la permiso de HIGH_SAMPLING_RATE_SENSORS.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.requestPermissions();
Escuchar eventos
addListener devuelve un manejador. Llame a handle.remove() cuando la pantalla se desmonta, o LightSensor.removeAllListeners() para eliminar cada oyente.
Referencia completa
Siga adelante desde Usando @capgo/capacitor-sensor de luz
Si está utilizando Usando @capgo/capacitor-sensor de luz para planificar la consola de dashboard y API operaciones, conecte con @capgo/capacitor-sensor de luz para el detalle de implementación en @capgo/capacitor-sensor de luz Getting Started para el detalle de implementación en Comenzar Resumen de API para el detalle de implementación en Resumen de API Introducción para el detalle de implementación en Introducción, y Claves de API para el detalle de implementación en Claves de API.