Saltare al contenuto principale
Torna ai plugin
@capgo/capacitor-sensore di luce
Istruzioni
@capgo/capacitor-sensore di luce

Sensore di luce

Accedi al sensore di luce ambientale per misurare i livelli di illuminanza in lumen con aggiornamenti in tempo reale

Guida

Tutoriale sul Sensore di Luce

Testare sul dispositivo

Scarica l'app Capgo, poi scansione il QR code.

Collegamento QR di anteprima del plugin del sensore di luce code

Utilizzo di @capgo/capacitor-light-sensor

Plugin Capacitor per l'accesso al sensore di luce ambientale del dispositivo.

Installa

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

Cos'è questo plugin

  • isAvailable - Verifica se il sensore di luce è disponibile sul dispositivo corrente. Verifica sempre la disponibilità del sensore prima di tentare di utilizzarlo.
  • start - Inizia a ricevere aggiornamenti del sensore di luce. Ciò inizierà le misurazioni del sensore con l'intervallo specificato. Utilizza addListener - Ferma di ricevere aggiornamenti del sensore di luce. Ciò fermerà il sensore e risparmierà la batteria.
  • stop - Ferma di ricevere aggiornamenti del sensore di luce. Ciò fermerà il sensore e risparmierà la batteria.
  • checkPermissions - Controlla lo stato di autorizzazione corrente per i sensori con alta frequenza di campionamento. Su Android 12+, è richiesta la autorizzazione HIGH_SAMPLING_RATE_SENSORS per intervalli di aggiornamento dei sensori inferiori a 200ms.

Utilizzo di esempio

isAvailable

Controlla se il sensore di luce è disponibile sul dispositivo corrente. Dovresti sempre verificare la disponibilità del sensore prima di tentare di utilizzarlo.

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

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

start

Inizia a ricevere aggiornamenti dei sensori di luce. Ciò inizierà le misurazioni dei sensori all'intervallo specificato. Utilizza addListener per ricevere i dati dei sensori.

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

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

stop

Smetti di ricevere aggiornamenti dei sensori di luce. Ciò fermerà il sensore e risparmierà la batteria.

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

await LightSensor.stop();

checkPermissions

Controlla lo stato di autorizzazione corrente per i sensori con alta frequenza di campionamento. Su Android 12+, è richiesta la autorizzazione HIGH_SAMPLING_RATE_SENSORS per intervalli di aggiornamento dei sensori inferiori a 200ms.

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

const status = await LightSensor.checkPermissions();

Riferimento completo

Keep going from Using @capgo/capacitor-light-sensor

If sei stai utilizzando Utilizzando @capgo/capacitor-sensore di luce per pianificare il dashboard e le operazioni di API, connettilo con @capgo/capacitor-sensore di luce per i dettagli di implementazione in @capgo/capacitor-sensore di luce, Iniziare per i dettagli di implementazione in Iniziare, Panoramica di API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, e Chiavi di API per i dettagli di implementazione in API Chiavi.