blob: bc557ba052596d3f9222b3856a04fe3409682efe [file] [log] [blame]
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
[
{
"namespace": "idle",
"description": "Use the <code>chrome.idle</code> API to detect when the machine's idle state changes.",
"types": [
{
"id": "IdleState",
"type": "string",
"enum": [
"active",
"idle",
"locked"
]
}
],
"functions": [
{
"name": "queryState",
"type": "function",
"description": "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": [
{
"name": "detectionIntervalInSeconds",
"type": "integer",
"minimum": 15,
"description": "The system is considered idle if detectionIntervalInSeconds seconds have elapsed since the last user input detected."
},
{
"name": "callback",
"type": "function",
"parameters": [
{
"name": "newState",
"$ref": "IdleState"
}
]
}
]
},
{
"name": "setDetectionInterval",
"type": "function",
"description": "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": [
{
"name": "intervalInSeconds",
"type": "integer",
"minimum": 15,
"description": "Threshold, in seconds, used to determine when the system is in an idle state."
}
]
},
{
"name": "getAutoLockDelay",
"type": "function",
"description": "Gets the time, in seconds, it takes until the screen is locked automatically while idle. Returns a zero duration if the screen is never locked automatically. Currently supported on Chrome OS only.",
"parameters": [
{
"name": "callback",
"type": "function",
"parameters": [
{
"name": "delay",
"type": "integer",
"description": "Time, in seconds, until the screen is locked automatically while idle. This is zero if the screen never locks automatically."
}
]
}
]
}
],
"events": [
{
"name": "onStateChanged",
"type": "function",
"description": "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.",
"parameters": [
{
"name": "newState",
"$ref": "IdleState"
}
]
}
]
}
]