說明
使用 chrome.idle
API 偵測機器的閒置狀態何時變更。
權限
idle
資訊清單
您必須在擴充功能的資訊清單中宣告「閒置」權限,才能使用閒置 API。舉例來說:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
類型
IdleState
列舉
方法
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
取得等待時間 (秒),讓螢幕在閒置時自動鎖定。如果螢幕一律不自動鎖定,會傳回零時間長度。這項功能目前僅適用於 ChromeOS。
參數
-
回呼
函式選用
callback
參數如下所示:(delay: number) => void
-
delay
號碼
時間 (以秒為單位),直到螢幕在閒置時自動鎖定。如果螢幕永不自動鎖定,則值為 0。
-
傳回
-
Promise<number>
Chrome 116 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
如果系統處於鎖定狀態,系統會傳回「已鎖定」;如果使用者超過指定的秒數,則傳回「閒置」,否則傳回「啟用」。
參數
-
detectionIntervalInSeconds
號碼
如果偵測間隔秒數自上次偵測到使用者輸入內容後已過,系統就會將其視為閒置。
-
回呼
函式選用
callback
參數如下所示:(newState: IdleState) => void
-
newState
-
傳回
-
Promise<IdleState>
Chrome 116 以上版本Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
設定間隔 (以秒為單位),用來判斷系統何時為 onStateChanged 事件處於閒置狀態。預設間隔為 60 秒。
參數
-
intervalInSeconds
號碼
門檻 (以秒為單位) 可用於判斷系統何時處於閒置狀態。