electron/docs-translations/zh-CN/api/power-save-blocker.md
2016-10-11 22:36:11 -07:00

48 lines
No EOL
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# powerSaveBlocker
`powerSaveBlocker` 模块是用来阻止应用系统进入睡眠模式的,因此这允许应用保持系统和屏幕继续工作.
例如:
```javascript
const powerSaveBlocker = require('electron').powerSaveBlocker
var id = powerSaveBlocker.start('prevent-display-sleep')
console.log(powerSaveBlocker.isStarted(id))
powerSaveBlocker.stop(id)
```
## 方法
`powerSaveBlocker` 模块有如下方法:
### `powerSaveBlocker.start(type)`
* `type` String - 强行保存阻塞类型.
* `prevent-app-suspension` - 阻止应用挂起.
保持系统活跃,但是允许屏幕不亮. 用例:
下载文件或者播放音频.
* `prevent-display-sleep`- 阻止应用进入休眠. 保持系统和屏幕活跃,屏幕一直亮. 用例: 播放音频.
开始阻止系统进入睡眠模式.返回一个整数这个整数标识了保持活跃的blocker.
**注意:** `prevent-display-sleep` 有更高的优先级
`prevent-app-suspension`. 只有最高优先级生效. 换句话说, `prevent-display-sleep` 优先级永远高于
`prevent-app-suspension`.
例如, A 请求调用了 `prevent-app-suspension`, B请求调用了 `prevent-display-sleep`. `prevent-display-sleep`
将一直工作直到B停止调用. 在那之后, `prevent-app-suspension`
才起效.
### `powerSaveBlocker.stop(id)`
* `id` Integer - 通过 `powerSaveBlocker.start` 返回的保持活跃的 blocker id.
让指定blocker 停止活跃.
### `powerSaveBlocker.isStarted(id)`
* `id` Integer - 通过 `powerSaveBlocker.start` 返回的保持活跃的 blocker id.
返回 boolean 是否对应的 `powerSaveBlocker` 已经启动.