このページは大阪弁化フィルタによって翻訳生成されたんですわ。

翻訳前ページへ
chrome.idle - Google Chrome
The Wayback Machine - http://web.archive.org/web/20130826010002/http://developer.chrome.com/extensions/idle.html

chrome.idle

Description: Use the chrome.idle API to detect when the machine's idle state changes.
Availability: Stable since Chrome 6.
Permissions: "idle"

Manifest

You must declare the "idle" permission in your extension's manifest to use the idle API. For example: 

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

chrome.idle reference

Methods

queryState

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

Returns "locked" if the system is locked, "idle" if the user has not generated any input for a specified number of seconds, or "active" otherwise.

Parameters

detectionIntervalInSeconds ( integer )
The system is considered idle if detectionIntervalInSeconds seconds have elapsed since the last user input detected.
callback ( function )

Callback

The callback parameter should specify a function that looks like this: 

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

setDetectionInterval

chrome.idle.setDetectionInterval(integer intervalInSeconds)

Sets the interval, in seconds, used to determine when the system is in an idle state for onStateChanged events. The default interval is 60 seconds.

Parameters

intervalInSeconds ( integer )
Threshold, in seconds, used to determine when the system is in an idle state.

Events

onStateChanged

Fired when the system changes to an active, idle or locked state. The event fires with "locked" if the screen is locked or the screensaver activates, "idle" if the system is unlocked and the user has not generated any input for a specified number of seconds, and "active" when the user generates input on an idle system.

addListener

chrome.idle.onStateChanged.addListener(function callback)

Parameters

callback ( function )

Callback

The callback parameter should specify a function that looks like this: 

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

Sample Extensions that use chrome.idle

  • Idle - Simple Example – Demonstrates the Idle API