Guida
Come utilizzare la Luminosità in Capacitor
Utilizza @capgo/capacitor-luminosità
Regola la luminosità dello schermo su iOS e Android.
Installa
bun add @capgo/capacitor-brightness
bunx cap sync
bunx cap sync copia il nativo code del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CapgoBrightness } from '@capgo/capacitor-brightness';
Vedi API in un colpo d'occhio
| Metodo | Descrizione |
|---|---|
getBrightness |
Ottieni il livello di luminosità corrente dello schermo principale del dispositivo. |
setBrightness |
Imposta il livello di luminosità dello schermo principale del dispositivo. |
getSystemBrightness |
Ottieni la luminosità dello schermo di sistema. |
setSystemBrightness |
Imposta la luminosità dello schermo di sistema. Richiede la permessione WRITE_SETTINGS su Android. Ciò cambia anche il modalità di luminosità a MANUALE. |
getSystemBrightnessMode |
Ottieni il modalità di luminosità di sistema corrente (automatica o manuale). Richiede la permessione WRITE_SETTINGS su Android. |
setSystemBrightnessMode |
Imposta il modalità di luminosità di sistema (automatica o manuale). Richiede la permessione WRITE_SETTINGS su Android. |
isUsingSystemBrightness |
Verifica se l'attività corrente utilizza il valore di luminosità di sistema. |
restoreSystemBrightness |
Ripristina la impostazione di luminosità dell'attività corrente per utilizzare il valore di sistema. |
isAvailable |
Verifica se il Brightness API è disponibile sul dispositivo corrente. |
checkPermissions |
Verifica le autorizzazioni dell'utente per accedere alla luminosità di sistema. |
requestPermissions |
Richiedi autorizzazioni per accedere alla luminosità del sistema. Su Android, ciò apre le impostazioni del sistema per concedere la permessione WRITE_SETTINGS. |
Esempi
getBrightness()
Ottenere il livello di luminosità attuale della schermata principale del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getBrightness();
console.log(result);
setBrightness()
Impostare il livello di luminosità della schermata principale del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
Ottenere la luminosità della schermata di sistema.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
Imposta la luminosità dello schermo di sistema. Richiede la permessione WRITE_SETTINGS su Android. Ciò cambia anche il modalità di luminosità a MANUALE.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
Ottenere il modalità di luminosità di sistema attuale (automatica o manuale). Richiede la permessione WRITE_SETTINGS su Android.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);
setSystemBrightnessMode()
Impostare il modalità di luminosità di sistema (automatica o manuale). Richiede la permessione WRITE_SETTINGS su Android.
import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });
I metodi principali sono elencati nella tabella sopra. I listener e gli aiuti di versione, nonché il contratto completo di ogni metodo, sono documentati nel repository GitHub.
Riferimento completo
Continua dall'uso di @capgo/capacitor-brightness
Se stai utilizzando Utilizza @capgo/capacitor-brightness Per pianificare il comportamento dei media e dell'interfaccia nativi, connettilo con @capgo/capacitor-brightness per i dettagli di implementazione in @capgo/capacitor-brightness Getting Started per i dettagli di implementazione in Iniziare Utilizza @capgo/capacitor-live-activities per la capacità nativa in Utilizza @capgo/capacitor-live-activities @capgo/capacitor-attività-in-vivo per i dettagli di implementazione in @capgo/capacitor-live-attività, e Utilizzando @capgo/capacitor-video-player per la capacità nativa in Utilizzando @capgo/capacitor-video-player.