chrome.power

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()

Promise Chrome 113 e versioni successive Solo ChromeOS 
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