Zum Hauptinhalt springen
@capgo/capacitor-leuchtschalter Geräte-APIs Open Source

Leuchtschalter Capacitor Plugin

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

Installieren

bun add @capgo/capacitor-light-sensor bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-light-sensor
  • pnpm add @capgo/capacitor-light-sensor
  • yarn add @capgo/capacitor-light-sensor

Anleitung

Der Einsatz von Light Sensor in Capacitor

Testen auf Gerät

Laden Sie die Capgo-App herunter, dann scannen Sie die QR-code.

Vorschau-Link für das Licht-Sensor-Plugin (QR code)

Verwendung von @capgo/capacitor-light-sensor

Capacitor-Plugin für den Zugriff auf das Lichtsensor des Geräts

Installieren

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

bunx cap sync kopiert das native code-Plugin in Ihre native Projekte. Führen Sie es erneut durch, nachdem Sie jede Plugin-Upgrade durchgeführt haben.

Importieren

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

API-Übersicht

Methode Beschreibung
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.
start Beginnen Sie mit dem Abhören von Lichtsensor-Updates. Dies beginnt die Sensormessungen mit der angegebenen Intervallzeit. Verwenden Sie addListener um die Sensor-Daten zu erhalten.
stop Beenden Sie das Abhören von Lichtsensor-Updates. Dies stoppt den Sensor und spart Batterie.
checkPermissions Überprüfen Sie den aktuellen Berechtigungsstatus für Hochauflösungssensoren. Auf Android 12+ ist die Berechtigung für Hochauflösungssensoren erforderlich, wenn die Sensor-Update-Intervalle unter 200ms liegen.
requestPermissions Berechtigung für hochauflösende Sensoren anfordern. Bei Android 12+ wird die Berechtigung für HIGH_SAMPLING_RATE_SENSORS angefordert.

Beispiele

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 Lichtsensor-Updates. Dies beginnt die Sensormessungen mit der angegebenen Intervallzeit. 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 Lichtsensor-Updates. Dies stoppt den Sensor und spart Batterie.

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

await LightSensor.stop();

checkPermissions()

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

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

const status = await LightSensor.checkPermissions();

requestPermissions()

Die Berechtigung für Hochdurchsatzsensoren anfordern. Auf Android 12+ wird die Berechtigung HIGH_SAMPLING_RATE_SENSORS angefordert.

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

const status = await LightSensor.requestPermissions();

Hören Sie auf Ereignisse

addListener erstellt einen Handle. Aufrufen Sie handle.remove() wenn das Bildschirm unmontiert wird, oder LightSensor.removeAllListeners() um jeden Listener zu löschen.

Vollständige Referenz

Fortsetzen von Using @capgo/capacitor-light-sensor

Wenn Sie Hochdurchsatzsensoren verwenden Mit @capgo/capacitor-lichtsensor um das Dashboard und API-Operationen zu planen, verbinden Sie es mit @capgo/capacitor-lichtsensor für die Implementierungsdetails in @capgo/capacitor-lichtsensor Getting Started für die Implementierungsdetails in Einstieg API-Übersicht für die Implementierungsdetails in API-Übersicht Einführung für die Implementierungsdetails in Einführung, und API-Schlüssel für die Implementierungsdetails in API-Schlüssel

FAQ

FAQs zum Lichtsensor-Plugin

Wie installiere ich das Lichtsensor-Plugin in einer Capacitor-App?

Führen Sie "bun add @capgo/capacitor-light-sensor" (oder "npm install @capgo/capacitor-light-sensor") aus, führen Sie dann "bunx cap sync" aus, damit die iOS- und Android-Projekte die native code aufnehmen. Importieren Sie es aus "@capgo/capacitor-light-sensor" in Ihrer code-Anwendung.

Funktioniert @capgo/capacitor-light-sensor mit React, Vue und Angular?

Ja. Das Lichtsensor-Plugin ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-light-sensor?

Capgo-Plugins folgen der Capacitor-Majorversion: Wählen Sie die Plugin-Majorversion, die Ihrer Capacitor-Majorversion entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitätsübersicht im GitHub-README enthält die unterstützten Versionen.

Ist @capgo/capacitor-light-sensor kostenlos und Open-Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-light-sensor/ verfügbar und das Paket kann kostenlos installiert werden von npm. Bugberichte und Pull Requests sind willkommen.

Kann ich code aktualisieren, das Light Sensor verwendet, ohne eine App-Store-Bewertung?

Das Installieren oder Upgraden des Plugins ändert die native code, daher benötigt es eine neue Store-Build. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die den Pluginaufruf enthalten, sofort mit Capgo-Live-Updates verschickt werden.

Schicken Sie Änderungen am Lichtsensor ohne auf eine App-Überprüfung zu warten

Einmal, wenn das Plugin in Ihrem Laden ist, Capgo live Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an die Benutzer in Minuten.

Starten Sie mit Capgo