說明
使用 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()
browser.power.reportActivity(): Promise<void>
回報使用者活動,以便從調暗或關閉狀態或螢幕保護程式喚醒螢幕。如果螢幕保護程式目前處於啟用狀態,則會退出。
傳回
-
承諾<void>
requestKeepAwake()
browser.power.requestKeepAwake(
level: Level,
): void
要求暫時停用電源管理功能。level 說明應停用電源管理的程度。如果相同應用程式先前發出的要求仍有效,系統會以新要求取代。
參數
-
等級