Saltare al contenuto principale
@capgo/capacitor-sensore di luce API di dispositivo Sorgente aperta

Sensore di Luce Plugin Capacitor

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

Installa

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

Guida

Come utilizzare il sensore di luce in Capacitor

Testa sul dispositivo

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

Anteprima del plugin del sensore di luce QR code

Utilizza @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

bunx cap sync Copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

Vedi API in un colpo d'occhio

Metodo Descrizione
isAvailable Verifica se il sensore di luce è disponibile sul dispositivo corrente. È sempre necessario 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 Smetti 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 di alta campionatura. Su Android 12+, è richiesta la autorizzazione HIGH_SAMPLING_RATE_SENSORS per intervalli di aggiornamento dei sensori inferiori a 200ms.
requestPermissions Richiedi autorizzazione per i sensori di alta campionatura. Su Android 12+, ciò richiede l'autorizzazione HIGH_SAMPLING_RATE_SENSORS.

Esempi

isAvailable()

Verifica se il sensore di luce è disponibile sul dispositivo corrente. È sempre necessario verificare la disponibilità del sensore prima di utilizzarlo.

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

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

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.

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

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

stop()

Smetti di ricevere aggiornamenti sul 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 permessione 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();

requestPermissions()

Richiedi la permessione per i sensori con alta frequenza di campionamento. Su Android 12+, si richiede la permessione 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 lo schermo viene smontato, o LightSensor.removeAllListeners() per cancellare ogni ascoltatore.

Riferimento completo

Continua da Utilizzo di @capgo/capacitor-light-sensor

Se stai utilizzando Utilizzando @capgo/capacitor-sensore di luce per pianificare la dashboard e le operazioni di API, connettilo con @capgo/capacitor-sensore di luce per i dettagli di implementazione in @capgo/capacitor-sensore di luce, Avvio rapido per i dettagli di implementazione in Avvio rapido, 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 Chiavi di API.

FAQ

Faq del plugin del sensore di luce

How installo il plugin del sensore di luce in un'app Capacitor?

Run "bun add @capgo/capacitor-light-sensor" (o "npm install @capgo/capacitor-light-sensor"), poi run "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-light-sensor" nella tua app code.

Funziona @capgo/capacitor-light-sensor con React, Vue e Angular?

Sì. Il sensore di luce è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-light-sensor?

Il plugin Capgo segue la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README del GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-light-sensor?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-light-sensor/ e il pacchetto è gratuito per l'installazione da npm. Sono accetti i segnalazioni di bug e le richieste di pull.

Posso aggiornare code che utilizza il sensore di luce senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il nativo code, quindi richiede una nuova costruzione del store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con Capgo live updates.

Consegui cambiamenti del sensore di luce senza aspettare la revisione dell'app

Una volta che il plugin è presente nella tua store build, Capgo aggiornamenti in tempo reale inviano i tuoi cambiamenti JavaScript, HTML e CSS ai tuoi utenti in pochi minuti.

Inizia con Capgo