browser.power

說明

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

權限

power

概念和用途

根據預設,作業系統會在使用者閒置時調暗螢幕,最後暫停系統。應用程式或擴充功能可透過 Power API 讓系統保持喚醒狀態。

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

如果使用者有多個應用程式或擴充功能處於啟用狀態,且每個應用程式或擴充功能都有自己的電源等級,則優先順序最高的等級會生效;"display" 的優先順序一律高於 "system"。舉例來說,如果應用程式 A 要求 "system" 電源管理,而應用程式 B 要求 "display",則系統會使用 "display",直到應用程式 B 卸載或釋出要求為止。如果應用程式 A 仍處於啟用狀態,則會使用 "system"。

類型

Level

列舉

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

"display"
防止螢幕關閉或調暗,或防止系統在使用者閒置時進入休眠狀態。

方法

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

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

reportActivity()

Chrome 113 以上版本 Chrome 148 以上版本:browser.* 僅適用於 ChromeOS
browser.power.reportActivity(): Promise<void>

回報使用者活動,以便從調暗或關閉狀態或螢幕保護程式喚醒螢幕。如果螢幕保護程式目前處於啟用狀態,則會退出。

傳回

  • 承諾<void>

requestKeepAwake()

browser.power.requestKeepAwake(
  level: Level,
)
: void

要求暫時停用電源管理功能。level 說明應停用電源管理的程度。如果相同應用程式先前發出的要求仍有效,系統會以新要求取代。

參數