chrome.power

說明

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

權限

power

概念與用途

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

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

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

類型

Level

列舉

「system」
防止系統因使用者閒置而進入休眠狀態。

「display」
防止螢幕關閉或調暗,或系統因使用者閒置而進入休眠狀態。

方法

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

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

reportActivity()

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

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

傳回

  • Promise<void>

requestKeepAwake()

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

要求暫時停用電源管理。level 說明應停用電源管理的程度。如果同一應用程式先前提出的要求仍處於有效狀態,系統會以新要求取代舊要求。

參數