Anleitung
So nutzt du Brightness in Capacitor
Auf dem Gerät testen
Lade die Capgo App herunter und scanne den QR code.
@capgo/capacitor-brightness verwenden
Steuerung der Bildschirmhelligkeit auf iOS und Android.
Installieren
bun add @capgo/capacitor-brightness
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 { CapgoBrightness } from '@capgo/capacitor-brightness';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
getBrightness |
Lies die aktuelle Helligkeit des Hauptbildschirms des Geräts aus. |
setBrightness |
Stelle die Helligkeit des Hauptbildschirms des Geräts ein. |
getSystemBrightness |
Die systemweite Bildschirmhelligkeit abrufen. |
setSystemBrightness |
Die systemweite Bildschirmhelligkeit festlegen. Erfordert auf Android die Berechtigung WRITE_SETTINGS. Außerdem wird der Helligkeitsmodus auf MANUAL gesetzt. |
getSystemBrightnessMode |
Den aktuellen Helligkeitsmodus des Systems abrufen (automatisch oder manuell). Erfordert auf Android die Berechtigung WRITE_SETTINGS. |
setSystemBrightnessMode |
Den Helligkeitsmodus des Systems festlegen (automatisch oder manuell). Erfordert auf Android die Berechtigung WRITE_SETTINGS. |
isUsingSystemBrightness |
Prüft, ob die aktuelle Activity den systemweiten Helligkeitswert verwendet. |
restoreSystemBrightness |
Setzt die Helligkeitseinstellung der aktuellen Activity auf den systemweiten Wert zurück. |
isAvailable |
Prüft, ob das Brightness-API auf dem aktuellen Gerät verfügbar ist. |
checkPermissions |
Prüft die Berechtigungen des Nutzers für den Zugriff auf die Systemhelligkeit. |
requestPermissions |
Fordert Berechtigungen für den Zugriff auf die Systemhelligkeit an. Unter Android öffnet dies die Systemeinstellungen, um die WRITE_SETTINGS-Berechtigung zu erteilen. |
Beispiele
getBrightness()
Lies die aktuelle Helligkeit des Hauptbildschirms des Geräts aus.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getBrightness();
console.log(result);
setBrightness()
Stelle die Helligkeit des Hauptbildschirms des Geräts ein.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
Die systemweite Bildschirmhelligkeit abrufen.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
Die systemweite Bildschirmhelligkeit festlegen. Erfordert auf Android die Berechtigung WRITE_SETTINGS. Außerdem wird der Helligkeitsmodus auf MANUAL gesetzt.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
Den aktuellen Helligkeitsmodus des Systems abrufen (automatisch oder manuell). Erfordert auf Android die Berechtigung WRITE_SETTINGS.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);
setSystemBrightnessMode()
Den Helligkeitsmodus des Systems festlegen (automatisch oder manuell). Erfordert auf Android die Berechtigung WRITE_SETTINGS.
import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });
Die obige Tabelle listet die 11 Kernmethoden auf. Listener- und Versions-Helper sowie die vollständigen Contracts jeder Methode sind in der GitHub Repository.
Vollständige Referenz
Weiter mit @capgo/capacitor-brightness
Wenn du es nutzt @capgo/capacitor-brightness verwenden , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-brightness für die Implementierungsdetails in @capgo/capacitor-brightness, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“