說明
使用 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()
chrome.power.reportActivity(
callback?: function,
)
回報使用者活動,以便從變暗/關閉狀態或螢幕保護程式喚醒螢幕。如果螢幕保護程式目前處於啟用狀態,會結束螢幕保護程式。
參數
-
回呼
函式選用
callback
參數如下所示:() => void
傳回
-
Promise<void>
Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
)
要求暫時停用電源管理。level
說明應停用電源管理功能的時間長度。如果同一個應用程式先前提出的要求仍在運作,系統會將其替換為新的要求。
參數
-
level