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