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

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

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Enlace QR de vista previa del plugin de sensor de luz code

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 con 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 usarlo.
  • start - Comenzar a escuchar actualizaciones del sensor de luz. Esto iniciará 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

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 de sensores inferiores a 200ms.

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

const status = await LightSensor.checkPermissions();

Referencia Completa

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

Si está utilizando Usando @capgo/capacitor-sensor-de-luz para planificar la consola y las operaciones API, conectarlo con @capgo/capacitor-sensor-de-luz para los detalles de implementación en @capgo/capacitor-sensor-de-luz Inicio para los detalles de implementación en Inicio Resumen de API para los detalles de implementación en Resumen de API Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en Claves de API.