Descrizione
Utilizza l'API chrome.power
per eseguire l'override delle funzionalità di gestione dell'alimentazione del sistema.
Autorizzazioni
power
Concetti e 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 in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al 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