This page was saved using WebZIP 7.0.3.1030 offline browser on 12/24/13 11:31:36.
Address: https://crxdoc-zh.appspot.com/extensions/idle.html
Title: chrome.idle - Google Chrome 扩展程序开发文档(非官方中文版)  •  Size: 23030

chrome.idle

描述 使用 chrome.idle API 检测计算机空闲状态的更改。
可用版本 从 Chrome 6 开始稳定支持。
权限 "idle"

清单文件

您必须在扩展程序的清单文件中声明 "idle" 权限才能使用空闲处理 API。例如:

{
  "name": "我的扩展程序",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

chrome.idle 参考

方法

queryState

chrome.idle.queryState(integer detectionIntervalInSeconds, function callback)

如果系统已锁定则返回 "locked",如果用户在指定时间(以秒为单位)内没有任何输入则返回 "idle",否则返回 "active"。

参数

detectionIntervalInSeconds ( integer )

如果最后一次检测到用户输入后经过了 detectionIntervalInSeconds 秒则认为系统空闲。

callback ( function )

callback 参数应该指定一个如下形式的函数:

function(enum of "active", "idle", or "locked" newState) {...};

newState ( enum of "active", "idle", or "locked" )

setDetectionInterval

chrome.idle.setDetectionInterval(integer intervalInSeconds)

设置以秒为单位的间隔,用来确定 onStateChanged 事件中系统是否处于空闲状态,默认间隔为 60 秒。

参数

intervalInSeconds ( integer )

以秒为单位的阈值,用来确定系统是否处于空闲状态。

事件

onStateChanged

当系统状态变为活动、空闲或已锁定时产生。如果屏幕锁定或屏幕保护程序启动则产生该事件并传递 "locked",如果系统未锁定并且用户在以秒为单位的指定时间内没有任何输入则产生该事件并传递 "idle",如果用户系统空闲时产生输入则传递 "active"。

addListener

chrome.idle.onStateChanged.addListener(function callback)

参数

callback ( function )

callback 参数应该指定一个如下形式的函数:

function(enum of "active", "idle", or "locked" newState) {...};

newState ( enum of "active", "idle", or "locked" )