add power-save-blocker first
This commit is contained in:
parent
29609b6e5d
commit
d96836e608
1 changed files with 48 additions and 0 deletions
48
docs-translations/zh-CN/api/power-save-blocker.md
Normal file
48
docs-translations/zh-CN/api/power-save-blocker.md
Normal file
|
@ -0,0 +1,48 @@
|
|||
# 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` 已经启动.
|
Loading…
Reference in a new issue