Guida
Come usare Brightness in Capacitor
Utilizzo di @capgo/capacitor-brightness
Controlla la luminosità dello schermo su iOS e Android.
Installa
bun add @capgo/capacitor-brightness
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { CapgoBrightness } from '@capgo/capacitor-brightness';
API in breve
| Metodo | Descrizione |
|---|---|
getBrightness |
Ottieni il livello di luminosità attuale dello schermo principale del dispositivo. |
setBrightness |
Imposta il livello di luminosità dello schermo principale del dispositivo. |
getSystemBrightness |
Ottieni la luminosità dello schermo a livello di sistema. |
setSystemBrightness |
Imposta la luminosità dello schermo a livello di sistema. Richiede il permesso WRITE_SETTINGS su Android. Questo imposta anche la modalità di luminosità su MANUAL. |
getSystemBrightnessMode |
Ottieni la modalità di luminosità di sistema attuale (automatica o manuale). Richiede il permesso WRITE_SETTINGS su Android. |
setSystemBrightnessMode |
Imposta la modalità di luminosità di sistema (automatica o manuale). Richiede il permesso WRITE_SETTINGS su Android. |
isUsingSystemBrightness |
Verifica se l'attività corrente sta utilizzando il valore di luminosità di sistema. |
restoreSystemBrightness |
Ripristina l'impostazione di luminosità dell'attività corrente per usare il valore di sistema. |
isAvailable |
Verifica se il API Brightness è disponibile sul dispositivo attuale. |
checkPermissions |
Controlla i permessi dell'utente per accedere alla luminosità di sistema. |
requestPermissions |
Richiedi i permessi per accedere alla luminosità di sistema. Su Android, questo apre le impostazioni di sistema per concedere il permesso WRITE_SETTINGS. |
Esempi
getBrightness()
Ottieni il livello di luminosità attuale dello schermo principale del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getBrightness();
console.log(result);
setBrightness()
Imposta il livello di luminosità dello schermo principale del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
Ottieni la luminosità dello schermo a livello di sistema.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
Imposta la luminosità dello schermo a livello di sistema. Richiede il permesso WRITE_SETTINGS su Android. Questo cambia anche la modalità di luminosità in MANUAL.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
Ottieni la modalità di luminosità di sistema attuale (automatico o manuale). Richiede il permesso WRITE_SETTINGS su Android.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);
setSystemBrightnessMode()
Imposta la modalità di luminosità di sistema (automatico o manuale). Richiede il permesso WRITE_SETTINGS su Android.
import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });
La tabella sopra elenca gli 11 metodi core. Listener, helper di versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Riferimento completo
Continua da Utilizzo di @capgo/capacitor-brightness
Se stai usando Utilizzo di @capgo/capacitor-brightness per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-brightness per i dettagli di implementazione in @capgo/capacitor-brightness, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.