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