Descrizione
Utilizza l'API chrome.power
per eseguire l'override delle funzionalità di gestione dell'alimentazione del sistema.
Autorizzazioni
power
Utilizzo
Per impostazione predefinita, i sistemi operativi attenuano la luminosità dello schermo quando gli utenti sono inattivi, fino a sospendere il sistema. Con l'API Power, un'app o un'estensione può mantenere attivo il sistema.
Utilizzando questa API, puoi specificare il Livello a cui viene disabilitata la gestione dell'alimentazione. Il livello "system"
mantiene il sistema attivo, ma consente la luminosità o lo spegnimento dello schermo. Ad esempio, un'app di comunicazione può continuare a ricevere messaggi quando lo schermo è disattivato. Il livello "display"
mantiene lo schermo e il sistema attivi. Le app per ebook e presentazioni, ad esempio, possono mantenere attivi lo schermo e il sistema durante la lettura.
Quando un utente ha più di un'app o estensione attiva, ciascuna con il proprio livello di potenza, viene applicato il livello di precedenza più elevato; "display"
ha sempre la precedenza su "system"
. Ad esempio, se l'app A richiede la gestione dell'alimentazione di "system"
e l'app B richiede la gestione di "display"
, "display"
viene utilizzata fino a quando l'app B non viene caricata o non rilascia la sua richiesta. Se l'app A è ancora attiva, viene
utilizzata "system"
.
Tipi
Level
Enum
"system"
Impedisce al sistema di dormire in risposta all'inattività dell'utente.
"display"
Consente di impedire lo spegnimento o l'oscuramento del display o la modalità di sospensione del sistema in risposta a inattività dell'utente.
Metodi
releaseKeepAwake()
chrome.power.releaseKeepAwake()
Rilascia una richiesta effettuata in precedenza tramite requestKeepAwake().
reportActivity()
chrome.power.reportActivity(
callback?: function,
)
Consente di segnalare l'attività di un utente al fine di riattivare lo schermo da uno stato attenuato o spento o da un salvaschermo. Chiude il salvaschermo se al momento è attivo.
Parametri
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
)
Richiede la disattivazione temporanea della gestione dell'alimentazione. level
indica il livello di disattivazione della gestione dell'alimentazione. Se una richiesta effettuata in precedenza dalla stessa app è ancora attiva, verrà sostituita dalla nuova richiesta.
Parametri
-
livello