chrome.idle
描述: |
使用 chrome.idle API 检测计算机空闲状态的更改。
|
可用版本: |
从 Chrome 6 开始支持。
|
权限: |
"idle"
|
清单文件
您必须在扩展程序的清单文件中声明 "idle" 权限才能使用空闲处理 API。例如:
{ "name": "我的扩展程序", ... "permissions": [ "idle" ], ... }
摘要
方法 | |
---|---|
queryState −
chrome.idle.queryState(integer detectionIntervalInSeconds, function callback)
| |
setDetectionInterval −
chrome.idle.setDetectionInterval(integer intervalInSeconds)
| |
事件 | |
onStateChanged |
方法
queryState
chrome.idle.queryState(integer detectionIntervalInSeconds, function callback)
如果系统已锁定则返回 "locked",如果用户在指定时间(以秒为单位)内没有任何输入则返回 "idle",否则返回 "active"。
参数 | |||||
---|---|---|---|---|---|
integer | detectionIntervalInSeconds |
从 Chrome 25 开始支持。 如果最后一次检测到用户输入后经过了 detectionIntervalInSeconds 秒则认为系统空闲。 |
|||
function | callback |
callback 参数应该是一个如下形式的函数: function(enum of
|
setDetectionInterval
chrome.idle.setDetectionInterval(integer intervalInSeconds)
从 Chrome 25 开始支持。
设置以秒为单位的间隔,用来确定 onStateChanged 事件中系统是否处于空闲状态,默认间隔为 60 秒。
参数 | ||
---|---|---|
integer | intervalInSeconds |
以秒为单位的阈值,用来确定系统是否处于空闲状态。 |
事件
onStateChanged
当系统状态变为活动、空闲或已锁定时产生。如果屏幕锁定或屏幕保护程序启动则产生该事件并传递 "locked",如果系统未锁定并且用户在以秒为单位的指定时间内没有任何输入则产生该事件并传递 "idle",如果用户系统空闲时产生输入则传递 "active"。
addListener
chrome.idle.onStateChanged.addListener(function callback)
参数 | |||||
---|---|---|---|---|---|
function | callback |
callback 参数应该是一个如下形式的函数: function(enum of
|
示例扩展程序
- Idle - Simple Example – Demonstrates the Idle API