electron/docs-translations/zh-CN/api/power-save-blocker.md
2016-03-13 22:06:19 +08:00

1.6 KiB
Raw Blame History

powerSaveBlocker

powerSaveBlocker 模块是用来阻止应用系统进入睡眠模式的,因此这允许应用保持系统和屏幕继续工作.

例如:

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 已经启动.