Vai alla sezione principale
Torna ai plugin
@capgo/capacitor-sensore-di-luce
Tutorial
@capgo/capacitor-sensore-di-luce

Sensore di luce

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

Guida

Tutorial sul sensore di luce

Utilizza @capgo/capacitor-sensore di luce

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

Installa

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

Cosa questo plugin espone

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

Esempio di utilizzo

isAvailable

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

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

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

start

Inizia ad ascoltare aggiornamenti del sensore di luce. Ciò inizierà le misurazioni del sensore all'intervallo specificato. Utilizza addListener per ricevere i dati del sensore.

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

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

stop

Ferma di ascoltare aggiornamenti del sensore 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

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

Se stai utilizzando Utilizzo di @capgo/capacitor-sensore di luce per pianificare il dashboard e le operazioni di API, collega il dispositivo con @capgo/capacitor-sensore di luce per i dettagli di implementazione in @capgo/capacitor-sensore di luce, Avvio per i dettagli di implementazione in Getting Started, API Panoramica per i dettagli di implementazione in API Panoramica, Introduzione per i dettagli di implementazione in Introduzione, e API Chiavi per i dettagli di implementazione in API Chiavi.