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 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 solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i 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