说明
使用 chrome.idle
API 检测机器的空闲状态何时发生变化。
权限
idle
您必须在扩展程序的清单中声明 "idle"
权限,才能使用空闲 API。例如:
{
"name": "My extension",
...
"permissions": [
"idle"
],
...
}
类型
IdleState
枚举
"有效"
"idle"
"已锁定"
方法
getAutoLockDelay()
chrome.idle.getAutoLockDelay(
callback?: function,
)
获取屏幕在闲置时自动锁定所用的时间(以秒为单位)。如果屏幕从不自动锁定,则返回时长为零。目前仅适用于 ChromeOS。
参数
-
callback
函数(可选)
callback
参数如下所示:(delay: number) => void
-
delay
number
屏幕在闲置时自动锁定所用的时间(以秒为单位)。如果屏幕永不自动锁定,则此值为零。
-
返回
-
Promise<number>
Chrome 116 及更高版本Manifest V3 及更高版本支持 Promise,但为以下项目提供回调: 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
queryState()
chrome.idle.queryState(
detectionIntervalInSeconds: number,
callback?: function,
)
返回“锁定”如果系统锁定,则“空闲”如果用户在指定秒数内未生成任何输入,则为“有效”否则。
参数
-
detectionIntervalInSeconds
number
如果自检测到上一次用户输入后经过了 DetectionIntervalInSeconds,则系统会将系统视为空闲。
-
callback
函数(可选)
callback
参数如下所示:(newState: IdleState) => void
-
newState
-
返回
-
Promise<IdleState>
Chrome 116 及更高版本Manifest V3 及更高版本支持 Promise,但为以下项目提供回调: 向后兼容性您不能在同一个函数调用中同时使用这两者。通过 promise 使用传递给回调的类型进行解析。
setDetectionInterval()
chrome.idle.setDetectionInterval(
intervalInSeconds: number,
)
设置时间间隔(以秒为单位),用于确定系统何时针对 onStateChanged 事件处于空闲状态。默认间隔为 60 秒。
参数
-
intervalInSeconds
number
阈值(以秒为单位),用于确定系统何时处于空闲状态。