Saltar al contenido principal
Volver a plugins
@capgo/capacitor-sensor de luz
Tutorial
por github.com/Cap-go

Sensor de luz

Acceda al sensor de luz ambiente para medir niveles de iluminancia en lux con actualizaciones en tiempo real

Guía

Tutorial sobre Sensor de Luz

Usando @capgo/capacitor-sensor-de-luz

Capacitor plugin para acceder al sensor de luz del dispositivo.

Instalar

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

¿Qué se expone con este plugin?

  • isAvailable - Verificar si el sensor de luz está disponible en el dispositivo actual. Siempre debe verificar la disponibilidad del sensor antes de intentar usarlo.
  • start - Comenzar 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 - Detener 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 HIGH_SAMPLING_RATE_SENSORS para intervalos de actualización de sensores inferiores a 200ms.

Ejemplo de uso

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. Utilice 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 HIGH_SAMPLING_RATE_SENSORS para intervalos de actualización de sensores inferiores a 200ms.

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

const status = await LightSensor.checkPermissions();

Referencia completa