Salta al contenuto principale
@capgo/capacitor-brightness API dei dispositivi Open source

Luminosità Plugin Capacitor

Controlla la luminosità dello schermo via codice, con supporto per impostazioni specifiche dell'app o a livello di sistema

Installa

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

Guida

Come usare Brightness in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

Anteprima plugin Brightness: QR code

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 dell'intero sistema.
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.
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 usando il valore di luminosità di sistema.
restoreSystemBrightness Ripristina l'impostazione di luminosità dell'attività corrente per usare il valore di sistema.
isAvailable Verifica se Brightness API è disponibile sul dispositivo corrente.
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 dell'intero 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 (automatica 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 (automatica 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 principali. Gli helper per listener e 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.

FAQ

FAQ del plugin Brightness

Come installo il plugin Brightness in un'app Capacitor?

Esegui "bun add @capgo/capacitor-brightness" (oppure "npm install @capgo/capacitor-brightness"), poi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-brightness" nel tuo code dell'app.

@capgo/capacitor-brightness funziona con React, Vue e Angular?

Sì. Brightness è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-brightness?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-brightness è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-brightness/ e il pacchetto è gratuito da installare da npm. Sono benvenuti bug report e pull request.

Posso aggiornare code che usa Brightness senza una revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche alla luminosità senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo