Saltar al contenido principal
Volver a plugins
@capgo/capacitor-sensor de luz
Tutoriales
@capgo/capacitor-sensor de luz

Sensor de luz

Acceda al sensor de luz ambiental 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

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

Instalar

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

¿Qué se expone en este plugin?

  • isAvailable - Verificar si el sensor de luz está disponible en el dispositivo actual. Siempre debes verificar la disponibilidad del sensor antes de intentar utilizarlo.
  • start - Comenzar a escuchar actualizaciones del sensor de luz. Esto comenzará las mediciones del sensor con el intervalo especificado. Utiliza 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 - Verificar 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 de sensores inferiores a 200ms.

Ejemplo de uso

isAvailable

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

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

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

start

Comenzar a escuchar actualizaciones del sensor de luz. Esto comenzará las mediciones del sensor con el intervalo especificado. Utiliza addListener para recibir los datos del sensor.

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

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

stop

Detener 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

Ver el estado de permiso actual para sensores de alta frecuencia de muestreo. En Android 12+, se requiere la permiso de 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

Sigue adelante desde Usando @capgo/capacitor-sensor-de-luz

Si estás utilizando Usando @capgo/capacitor-sensor-de-luz para planificar la consola de dashboard y operaciones de API, conecta con @capgo/capacitor-sensor-de-luz para obtener detalles de implementación en @capgo/capacitor-sensor-de-luz, Inicio de Sesión para el detalle de implementación en Getting Started, API Resumen para el detalle de implementación en API Resumen, Introducción para el detalle de implementación en Introducción, y API Claves para el detalle de implementación en API Claves.