Hauptinhalt überspringen
@capgo/capacitor-helligkeit Geräte-APIs Offene Quellen

Helligkeit Capacitor Plugin

Geräteneuerungsschirmhelligkeit programmgesteuert mit Unterstützung für Anwendungsspezifische und Systemweite Steuerung

Installieren

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

Anleitung

Wie man Helligkeit in Capacitor verwendet

Auf Gerät testen

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

Vorschau-QR code für das Helligkeits-Plugin

Verwende @capgo/capacitor-helligkeit

Steuere die Bildschirmhelligkeit auf iOS und Android.

Installieren

bun add @capgo/capacitor-brightness
bunx cap sync

bunx cap sync kopiert die native code des Plugins in Ihre native Projekte. Führen Sie es erneut durch, nachdem Sie das Plugin aktualisiert haben.

Importieren

import { CapgoBrightness } from '@capgo/capacitor-brightness';

API im Überblick

Methode Beschreibung
getBrightness Ermitteln Sie den aktuellen Helligkeitswert der Hauptbildschirm-Helligkeit des Geräts.
setBrightness Setzen Sie den Helligkeitswert der Hauptbildschirm-Helligkeit des Geräts.
getSystemBrightness Ermitteln Sie die Systembreite der Bildschirmhelligkeit.
setSystemBrightness Setzen Sie die Geräte-Helligkeit des gesamten Bildschirms. Erfordert die Berechtigung WRITE_SETTINGS auf Android. Dies ändert auch den Helligkeitsmodus auf HANDLICH.
getSystemBrightnessMode Ermitteln Sie den aktuellen System-Helligkeitsmodus (automatisch oder handlich). Erfordert die Berechtigung WRITE_SETTINGS auf Android.
setSystemBrightnessMode Setzen Sie den System-Helligkeitsmodus (automatisch oder handlich). Erfordert die Berechtigung WRITE_SETTINGS auf Android.
isUsingSystemBrightness Überprüfen Sie, ob die aktuelle Aktivität die Geräte-Helligkeitswerte verwendet.
restoreSystemBrightness Setzen Sie die Helligkeits-Einstellung der aktuellen Aktivität zurück, um die Geräte-Helligkeitswerte zu verwenden.
isAvailable Überprüfen Sie, ob die Helligkeits API auf dem aktuellen Gerät verfügbar ist.
checkPermissions Überprüfen Sie die Berechtigungen des Benutzers für den Zugriff auf die System-Helligkeit.
requestPermissions Berechtigungen für die Zugriff auf die Systemhelligkeit anfordern. Auf Android öffnet dies die Systemeinstellungen, um die Berechtigung für WRITE_SETTINGS zu erteilen.

Beispiele

getBrightness()

Ermitteln Sie die aktuelle Helligkeitseinstellung des Geräts für die Hauptanzeige.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getBrightness();
console.log(result);

setBrightness()

Die Helligkeit des Gerätschirms einstellen.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

await CapgoBrightness.setBrightness({ brightness: 0.5 });

getSystemBrightness()

Erhalte die Geräteseitige Bildschirmhelligkeit.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getSystemBrightness();
console.log(result);

setSystemBrightness()

Setze die Geräteseitige Bildschirmhelligkeit. Erfordert die Berechtigung WRITE_SETTINGS auf Android. Dies ändert auch die Helligkeitsmodus auf HANDSCHUH.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });

getSystemBrightnessMode()

Erhalte den aktuellen Systemhelligkeitsmodus (automatisch oder manuell). Erfordert die Berechtigung WRITE_SETTINGS auf Android.

import { CapgoBrightness } from '@capgo/capacitor-brightness';

const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);

setSystemBrightnessMode()

Setze den Systemhelligkeitsmodus (automatisch oder manuell). Erfordert die Berechtigung WRITE_SETTINGS auf Android.

import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';

await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });

Die Tabelle oben listet die 11 Kernmethoden auf. Helfer für Listener und Versionen sowie die vollständige Vertragsstruktur jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiter von Using @capgo/capacitor-helligkeit

Wenn Sie Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-helligkeit verwenden Using @capgo/capacitor-helligkeit um native Medien- und Benutzeroberflächengestaltung zu planen, verbinden Sie es mit für die Implementierungsdetails in @capgo/capacitor-helligkeit, für die Implementierungsdetails in @capgo/capacitor-Helligkeit, für die Implementierungsdetails in Zur Einführung, für die Implementierungsdetails im Getting Started Verwendung von @capgo/capacitor-live-Aktivitäten für die native Fähigkeit im @capgo/capacitor-live-aktivitäten @capgo/capacitor-live-Aktivitäten für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten und Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player.

FAQ

Helligkeits-Plugin-Häufig gestellte Fragen

Wie installiere ich das Helligkeits-Plugin in einer Capacitor-Anwendung?

Laufen Sie "bun add @capgo/capacitor-brightness" (oder "npm install @capgo/capacitor-brightness"), dann laufen Sie "bunx cap sync" so dass die iOS- und Android-Projekte die native code-Komponente aufnehmen. Importieren Sie sie aus "@capgo/capacitor-brightness" in Ihrer code-Anwendung.

Arbeitet @capgo/capacitor-brightness mit React, Vue und Angular?

Ja. Helligkeit ist ein Capacitor-Paket, also funktioniert sie mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Mit welcher Capacitor-Version unterstützt @capgo/capacitor-brightness?

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

ist @capgo/capacitor-brightness kostenlos und Open-Source?

Ja. Die Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-brightness/ und das Paket ist kostenlos von npm installierbar. Fehlermeldungen und Pull-Requests sind willkommen.

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

Die Installation oder das Upgrade des Plugins ändert die native code, es benötigt also eine neue Store-Build. Danach können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates verschickt werden.

Schaffe Helligkeitsänderungen ohne auf die App-Überprüfung zu warten

Einmal der Plugin in Ihrem Store-Build installiert, werden Capgo lebendige Updates Ihre JavaScript-, HTML- und CSS-Änderungen in Minuten an die Benutzer pushen.

Start mit Capgo