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 "active", "idle", or "locked" newState) {...};
enum of "active", "idle", or "locked" newState

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 "active", "idle", or "locked" newState) {...};
enum of "active", "idle", or "locked" newState

示例扩展程序