Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-lichtsensor
Tutorial
von github.com/Cap-go

Lichtsensor

Zugriff auf den Umgebungslichtsensor, um Helligkeitswerte in Lux mit Echtzeit-Updates zu messen

Richtlinie

Tutorial zum Lichtsensor

Verwendung von @capgo/capacitor-light-sensor

Capacitor-Plugin zum Zugriff auf den Lichtsensor des Geräts.

Installieren

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

Was dieses Plugin enthüllt

  • isAvailable - Überprüfen Sie, ob der Lichtsensor auf dem aktuellen Gerät verfügbar ist. Sie sollten immer die Sensorenlieferbarkeit überprüfen, bevor Sie versuchen, ihn zu verwenden.
  • start - Beginnen Sie mit dem Abhören von Lichtsensor-Updates. Dies wird die Sensormessungen auf der angegebenen Intervall beginnen. Verwenden Sie addListener um die Sensor-Daten zu erhalten.
  • stop - Beenden Sie das Abhören von Lichtsensor-Updates. Dies wird den Sensor beenden und die Batterie sparen.
  • checkPermissions - Überprüfen Sie den aktuellen Berechtigungsstatus für Hochdurchsatzsensoren. Bei Android 12+ ist die Berechtigung HIGH_SAMPLING_RATE_SENSORS erforderlich für Sensoraktualisierungen unter 200ms.

Beispielanwendung

isAvailable

Überprüfen Sie, ob der Lichtsensor auf dem aktuellen Gerät verfügbar ist. Sie sollten immer die Verfügbarkeit des Sensors überprüfen, bevor Sie ihn verwenden.

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

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

start

Beginnen Sie mit dem Abhören von Lichtsensoraktualisierungen. Dies wird die Sensormessungen auf der angegebenen Intervall beginnen. Verwenden Sie addListener um die Sensor-Daten zu erhalten.

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

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

stop

Beenden Sie das Abhören von Lichtsensoraktualisierungen. Dies wird den Sensor beenden und die Batterie sparen.

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

await LightSensor.stop();

checkPermissions

Überprüfen Sie den aktuellen Berechtigungsstatus für Hochdurchsatzsensoren. Bei Android 12+ ist die Berechtigung HIGH_SAMPLING_RATE_SENSORS erforderlich für Sensoraktualisierungen unter 200ms.

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

const status = await LightSensor.checkPermissions();

Vollständige Referenz