說明
使用 chrome.idle
API 偵測電腦閒置狀態的變化。
權限
idle
如要使用 Idle API,必須在擴充功能的資訊清單中聲明 "idle"
權限。例如:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
類型
IdleState
Chrome 44 以上版本
列舉
「active」
「idle」
「locked」
方法
getAutoLockDelay()
Chrome 73 以上版本
僅適用於 ChromeOS
chrome.idle.getAutoLockDelay(): Promise<number>
取得螢幕閒置時自動鎖定前的時間 (以秒為單位)。如果螢幕從未自動鎖定,則會傳回零時長。目前僅支援 ChromeOS。
傳回
-
Promise<number>
Chrome 116 以上版本
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
): Promise<IdleState>
如果系統已鎖定,則傳回「locked」;如果使用者在指定秒數內未產生任何輸入內容,則傳回「idle」;否則傳回「active」。
參數
-
detectionIntervalInSeconds
數字
如果自上次偵測到使用者輸入動作後經過 detectionIntervalInSeconds 秒,系統就會視為閒置。
傳回
-
Promise<IdleState>
Chrome 116 以上版本
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
): void
設定時間間隔 (以秒為單位),用於判斷系統何時處於 onStateChanged 事件的閒置狀態。預設間隔為 60 秒。
參數
-
intervalInSeconds
數字
判斷系統何時處於閒置狀態的門檻 (以秒為單位)。