chrome.power

說明

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

權限

power

用量

根據預設，作業系統會在使用者處於閒置狀態時調暗螢幕，最終將 有些人會將 Cloud Storage 視為檔案系統 但實際上不是只要使用 Power API，應用程式或擴充功能就能讓系統保持啟用狀態。

這個 API 可用於指定停用電源管理的 Level。"system" 水平儀，但允許螢幕變暗或關閉。舉例來說 即使螢幕關閉，通訊應用程式仍可繼續接收訊息。"display" 等級 讓螢幕和系統保持啟用狀態例如電子書和簡報應用程式可持續顯示螢幕畫面 以及系統啟動的

使用者啟用多個應用程式或擴充功能時，每個項目都有各自的電源等級， 採取優先順序最高的級別；"display" 的優先順序一律高於 "system"。適用對象 舉例來說，如果應用程式 A 要求 "system" 電源管理，而應用程式 B 要求 "display"，"display" ，直到應用程式 B 卸載或釋出其要求為止。如果應用程式 A 仍然有效，"system" 然後就使用

類型

Level

列舉

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

"display"
防止螢幕關閉或調暗，或是系統因閒置而進入休眠狀態。

方法

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

Promise Chrome 113 以上版本 僅適用於 ChromeOS 
chrome.power.reportActivity(
  callback?: function,
)

回報使用者活動，以便在變暗/關閉狀態或螢幕保護程式喚醒螢幕。如果螢幕保護程式目前為啟用狀態，就會退出螢幕。

參數

  • 回呼

    函式 選用

    callback 參數如下所示： 

    () => void

傳回

  • 承諾<void>

    Promise 僅適用於 Manifest V3 及以上版本，其他平台需要使用回呼。

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

已暫時停用電源管理的要求。level 說明電源管理的應停用程度。如果先前由相同應用程式提出的要求仍有效，新的要求將會取代現有要求。

參數