chrome.idle

Description

使用 chrome.idle API 来检测机器的空闲状态何时发生变化。

Permissions

idle

# Manifest

您必须在扩展程序的清单中声明“空闲idle”权限才能使用空闲 API。例如：

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

Summary

• Types

  IdleState

• Methods

  getAutoLockDelay

  queryState

  setDetectionInterval

• Events

  onStateChanged

Types

IdleState

Chrome 44+

TYPE

"active", "idle", or "locked"

Methods

getAutoLockDelay

chrome.idle.getAutoLockDelay(
  callback: function,
)

Chrome 73+

获取空闲时自动锁定屏幕所需的时间（以秒为单位）。如果屏幕从未自动锁定，则返回零持续时间。目前仅支持 Chrome 操作系统。

PARAMETERS

• callback

  function

  The callback parameter looks like:

  (delay: number) => void

  • delay

    number

    屏幕在空闲时自动锁定之前的时间（以秒为单位）。如果屏幕从不自动锁定，则为零。

queryState

chrome.idle.queryState(
  detectionIntervalInSeconds: number,
  callback: function,
)

如果系统被锁定，则返回“locked”，如果用户在指定的秒数内没有生成任何输入，则返回“idle”，否则返回“active”。

PARAMETERS

• detectionIntervalInSeconds

  number

  如果自上次检测到用户输入以来已经过去了 detectionIntervalInSeconds 秒，则系统被视为空闲。

• callback

  function

  The callback parameter looks like:

  (newState: IdleState) => void

  • newState

    IdleState

setDetectionInterval

chrome.idle.setDetectionInterval(
  intervalInSeconds: number,
)

设置时间间隔（以秒为单位），用于确定系统何时处于 onStateChanged 事件的空闲状态。默认间隔为 60 秒。

PARAMETERS

• intervalInSeconds

  number

  阈值，以秒为单位，用于确定系统何时处于空闲状态。

Events

onStateChanged

chrome.idle.onStateChanged.addListener(
  callback: function,
)

当系统更改为活动、空闲或锁定状态时触发。如果屏幕被锁定或屏幕保护程序激活，则事件以“locked”触发，如果系统已解锁且用户在指定的秒数内未生成任何输入，则为“idle”，当用户在空闲系统上生成输入时“active”。

PARAMETERS

• callback

  function

  The callback parameter looks like:

  (newState: IdleState) => void

  • newState

    IdleState

By.一粒技术服务.