Vai direttamente al contenuto principale
Torna ai plugin
@capgo/capacitor-sensore di luce
Tutorial
da github.com/Cap-go

Sensore di luce

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

Guida

Tutorial sul sensore di luce

Utilizzo di @capgo/capacitor-sensore-di-luce

Il plugin Capacitor per l'accesso al sensore di luce del dispositivo.

Installa

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

Cosa esporre con questo plugin

  • isAvailable - Verifica se il sensore di luce è disponibile sul dispositivo corrente. È sempre consigliabile verificare la disponibilità del sensore prima di utilizzarlo.
  • start - Inizia a ricevere aggiornamenti sul sensore di luce. Ciò inizierà le misurazioni del sensore con l'intervallo specificato. Utilizza addListener per ricevere i dati del sensore.
  • stop - Ferma di ricevere aggiornamenti sul sensore di luce. Ciò fermerà il sensore e risparmierà la batteria.
  • checkPermissions - Verifica 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.

Esempio di utilizzo

isAvailable

Verifica se il sensore di luce è disponibile sul dispositivo corrente. È sempre necessario verificare la disponibilità dei sensori prima di tentare di utilizzarli.

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

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

start

Inizia ad ascoltare gli aggiornamenti del sensore 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 ascoltare gli aggiornamenti del sensore di luce. Ciò fermerà il sensore e risparmierà la batteria.

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

await LightSensor.stop();

checkPermissions

Verifica 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