說明
使用 chrome.idle
API 偵測機器閒置狀態變更的時間。
權限
idle
您必須在擴充功能的資訊清單中宣告 "idle"
權限,才能使用閒置 API。例如:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
類型
IdleState
列舉
"active"
"idle"
"已鎖定"
方法
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,
)
傳回「已鎖定」訊息如果系統鎖定,「閒置」如果使用者未在指定秒數內產生任何輸入值,或是設為「active」反之。
參數
-
detectionIntervalInSeconds
數字
如果 DetectionIntervalInSeconds 秒鐘時間是系統從上次偵測到使用者輸入的時間起算,系統就會視為閒置。
-
回呼
函式 選用
callback
參數如下所示:(newState: IdleState) => void
-
newState
-
傳回
-
Promise<IdleState>
Chrome 116 以上版本Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
設定間隔 (以秒為單位),用來判斷 onStateChanged 事件中系統處於閒置狀態的時間。預設間隔為 60 秒。
參數
-
intervalInSeconds
數字
門檻 (以秒為單位),用來決定系統何時處於閒置狀態。