chrome.power

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 oscurano lo schermo quando gli utenti sono inattivi e alla fine sospenderanno di un sistema operativo completo. Con l'API Power, un'app o un'estensione può mantenere attivo il sistema.

Utilizzando questa API, è possibile specificare il Livello a cui la gestione dell'alimentazione è disabilitata. "system" livello mantiene attivo il sistema, ma consente di attenuare o spegnere lo schermo. Ad esempio, un L'app di comunicazione può continuare a ricevere messaggi anche quando lo schermo è spento. Il livello "display" mantiene lo schermo e il sistema attivi. Le app per ebook e presentazioni, ad esempio, possono mantenere lo schermo e il sistema sia attivo mentre gli utenti leggono.

Quando un utente ha più di un'app o estensione attiva, ciascuna con un proprio livello di alimentazione, viene il livello di precedenza più elevato diventa effettivo; "display" ha sempre la precedenza su "system". Per ad esempio, se l'app A richiede la gestione dell'alimentazione "system" e l'app B richiede "display", "display" Viene utilizzata finché l'app B non viene scaricata o non viene rilasciata la richiesta. Se l'app A è ancora attiva, "system" è e poi utilizzato.

Tipi

Level

Enum

"system"
Impedisce la modalità di sospensione del sistema in risposta all'inattività dell'utente.

"display"
Impedisce lo spegnimento o la luminosità del display oppure la sospensione del sistema in risposta all'inattività dell'utente.

Metodi

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Rilascia una richiesta precedentemente effettuata tramite requestKeepawake().

reportActivity()

Promesso Chrome 113 e versioni successive Solo ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

Segnala un'attività utente per riattivare lo schermo dopo che è stato oscurato o spento oppure da un salvaschermo. Chiude il salvaschermo se attualmente è attivo.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Richieste di 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