chrome.power

說明

使用 chrome.power API 覆寫系統的電源管理功能。

權限

power

概念和用法

根據預設，作業系統會在使用者處於閒置狀態時調暗螢幕，並在最終將系統暫停。而如果使用 Power API，應用程式或擴充功能可以使系統保持喚醒狀態。

這個 API 可指定停用電源管理功能的等級。"system" 層級可讓系統保持運作，但允許螢幕變暗或關閉。舉例來說，通訊應用程式可以在螢幕關閉時繼續接收訊息。"display" 層級可保持螢幕和系統啟用狀態。舉例來說，電子書和簡報應用程式可在使用者閱讀時，讓螢幕和系統保持啟用狀態。

如果使用者正在使用多個應用程式或擴充功能，而且每個應用程式或擴充功能都有各自的功率等級，優先順序最高層級會發揮作用；"display" 的優先順序一律高於 "system"。舉例來說，如果應用程式 A 要求 "system" 電源管理，而應用程式 B 要求 "display"，則只有在應用程式 B 卸載或釋出要求時，才會使用 "display"。如果應用程式 A 仍在使用中，則會使用 "system"。

類型

Level

列舉

"system"
防止系統在使用者閒置時進入休眠狀態。

"display"
防止螢幕關閉或調暗，或讓系統在回應使用者無活動時進入休眠狀態。

方法

releaseKeepAwake()

chrome.power.releaseKeepAwake()

釋出先前透過 requestKeepAwake() 提出的要求。

reportActivity()

Promise Chrome 113 以上版本 僅限 ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

回報使用者活動，以便從變暗/關閉狀態或螢幕保護程式喚醒螢幕。如果螢幕保護程式目前處於啟用狀態，會結束螢幕保護程式。

參數

  • 回呼

    函式選用

    callback 參數如下所示： 

    ()=>void

傳回

  • Promise<void>

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

要求暫時停用電源管理。level 說明應停用電源管理功能的時間長度。如果同一個應用程式先前提出的要求仍在運作，系統會將其替換為新的要求。

參數