Guida
Come usare Light Sensor in Capacitor
Utilizzo di @capgo/capacitor-light-sensor
Plugin Capacitor per accedere al sensore di luce ambientale del dispositivo.
Installa
bun add @capgo/capacitor-light-sensor
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { LightSensor } from '@capgo/capacitor-light-sensor';
API in breve
| Metodo | Descrizione |
|---|---|
isAvailable |
Verifica se il sensore di luce è disponibile sul dispositivo corrente. Controlla sempre la disponibilità del sensore prima di provare a usarlo. |
start |
Inizia a monitorare gli aggiornamenti del sensore di luce. Questo avvierà le misurazioni del sensore all'intervallo specificato. Usa addListener per ricevere i dati del sensore. |
stop |
Interrompe l'ascolto degli aggiornamenti del sensore di luce. Questo fermerà il sensore e risparmierà batteria. |
checkPermissions |
Controlla lo stato attuale dei permessi per i sensori ad alta frequenza di campionamento. Su Android 12+, il permesso HIGH_SAMPLING_RATE_SENSORS è richiesto per intervalli di aggiornamento del sensore inferiori a 200ms. |
requestPermissions |
Richiede il permesso per i sensori ad alta frequenza di campionamento. Su Android 12+, questo richiede il permesso HIGH_SAMPLING_RATE_SENSORS. |
Esempi
isAvailable()
Verifica se il sensore di luce è disponibile sul dispositivo corrente. Controlla sempre la disponibilità del sensore prima di provare a usarlo.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const { available } = await LightSensor.isAvailable();
start()
Inizia a monitorare gli aggiornamenti del sensore di luce. Questo avvierà le misurazioni del sensore all'intervallo specificato. Usa addListener per ricevere i dati del sensore.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.start({ updateInterval: 500 });
stop()
Interrompe l'ascolto degli aggiornamenti del sensore di luce. Questo fermerà il sensore e risparmierà batteria.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.stop();
checkPermissions()
Controlla lo stato attuale dei permessi per i sensori ad alta frequenza di campionamento. Su Android 12+, il permesso HIGH_SAMPLING_RATE_SENSORS è richiesto per intervalli di aggiornamento del sensore inferiori a 200ms.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.checkPermissions();
requestPermissions()
Richiede il permesso per i sensori ad alta frequenza di campionamento. Su Android 12+, questo richiede il permesso HIGH_SAMPLING_RATE_SENSORS.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.requestPermissions();
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando la schermata viene smontata, o LightSensor.removeAllListeners() per rimuovere tutti i listener.
Riferimento completo
Continua da Usare @capgo/capacitor-light-sensor
Se stai usando Utilizzo di @capgo/capacitor-light-sensor per pianificare le operazioni della dashboard e di API, collegalo a @capgo/capacitor-light-sensor per i dettagli di implementazione in @capgo/capacitor-light-sensor, Per iniziare per i dettagli di implementazione nella guida introduttiva, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli implementativi nell'Introduzione, e Chiavi API per i dettagli implementativi in API Keys.