Saltar al contenido principal
@capgo/capacitor-sensor de luz Dispositivos de API Fuente abierta

Sensor de luz plugin de Capacitor

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

Instalar

bun add @capgo/capacitor-light-sensor bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-light-sensor
  • pnpm add @capgo/capacitor-light-sensor
  • yarn add @capgo/capacitor-light-sensor

Guía

Cómo usar el sensor de luz en Capacitor

Probar en dispositivo

Descarga la aplicación Capgo, luego escanea el código QR code.

Enlace QR de vista previa del 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

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.

FAQ

Preguntas frecuentes del plugin de sensor de luz

Cómo instalo el plugin de sensor de luz en una aplicación de Capacitor?

Run "bun add @capgo/capacitor-sensor-luz" (o "npm install @capgo/capacitor-sensor-luz"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el nativo code. Importa desde "@capgo/capacitor-sensor-luz" en tu app code.

¿Funciona @capgo/capacitor-sensor-luz con React, Vue y Angular?

Sí. El sensor de luz es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Cuál es la versión Capacitor de @capgo/capacitor-sensor-luz?

Los plugins Capgo siguen la versión mayor de Capacitor: utiliza la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-sensor-luz gratuito y de código abierto?

Sí. El código fuente code está público en GitHub en https://github.com/Cap-go/capacitor-sensor-luz/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Puedo actualizar code que utiliza el sensor de luz sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviarlos instantáneamente con Capgo actualizaciones en vivo.

Envíe cambios del sensor de luz sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían los cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Comience con Capgo