Anleitung
So nutzt du den Light Sensor in Capacitor
Auf dem Gerät testen
Lade die Capgo App herunter und scanne den QR code.
@capgo/capacitor-light-sensor verwenden
Capacitor Plugin für den Zugriff auf den Umgebungslichtsensor des Geräts.
Installieren
bun add @capgo/capacitor-light-sensor
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { LightSensor } from '@capgo/capacitor-light-sensor';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
isAvailable |
Prüfen, ob der Lichtsensor auf dem aktuellen Gerät verfügbar ist. Du solltest die Verfügbarkeit des Sensors immer prüfen, bevor du ihn nutzt. |
start |
Beginne mit dem Abhören von Lichtsensor-Updates. Damit starten die Sensormessungen im angegebenen Intervall. Nutze addListener um die Sensordaten zu empfangen. |
stop |
Beende das Abhören von Lichtsensor-Updates. Dadurch wird der Sensor gestoppt und der Akku geschont. |
checkPermissions |
Den aktuellen Berechtigungsstatus für Sensoren mit hoher Abtastrate prüfen. Ab Android 12 ist die HIGH_SAMPLING_RATE_SENSORS-Berechtigung für Sensor-Update-Intervalle unter 200 ms erforderlich. |
requestPermissions |
Berechtigung für Sensoren mit hoher Abtastrate anfordern. Ab Android 12 wird damit die HIGH_SAMPLING_RATE_SENSORS-Berechtigung angefordert. |
Beispiele
isAvailable()
Prüfen, ob der Lichtsensor auf dem aktuellen Gerät verfügbar ist. Du solltest die Verfügbarkeit des Sensors immer prüfen, bevor du ihn nutzt.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const { available } = await LightSensor.isAvailable();
start()
Beginne mit dem Abhören von Lichtsensor-Updates. Damit starten die Sensormessungen im angegebenen Intervall. Nutze addListener um die Sensordaten zu empfangen.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.start({ updateInterval: 500 });
stop()
Beende das Abhören von Lichtsensor-Updates. Dadurch wird der Sensor gestoppt und der Akku geschont.
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.stop();
checkPermissions()
Den aktuellen Berechtigungsstatus für Sensoren mit hoher Abtastrate prüfen. Ab Android 12 ist die HIGH_SAMPLING_RATE_SENSORS-Berechtigung für Sensor-Update-Intervalle unter 200 ms erforderlich.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.checkPermissions();
requestPermissions()
Berechtigung für Sensoren mit hoher Abtastrate anfordern. Ab Android 12 wird damit die HIGH_SAMPLING_RATE_SENSORS-Berechtigung angefordert.
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.requestPermissions();
Events abonnieren
addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder LightSensor.removeAllListeners() auf, um alle Listener zu entfernen.
Vollständige Referenz
Weiter bei der Nutzung von @capgo/capacitor-light-sensor
Wenn du es nutzt @capgo/capacitor-light-sensor verwenden um Dashboard- und API-Operationen zu planen, verbinde es mit @capgo/capacitor-light-sensor für die Implementierungsdetails in @capgo/capacitor-light-sensor, Erste Schritte für die Implementierungsdetails in Erste Schritte, API Übersicht für Details zur Implementierung im API Overview, Einführung für die Implementierungsdetails in der Einleitung und API Schlüssel für die Implementierungsdetails in den API Keys.