跳到主要内容

powerMonitor

监控电源状态变化。

进程：主进程

事件​

`powerMonitor` 模块会触发以下事件

事件：'suspend'​

系统暂停时触发。

事件：'resume'​

系统恢复时触发。

事件：'on-ac' macOS Windows​

系统切换到交流电源时触发。

事件：'on-battery' macOS Windows​

系统切换到电池电源时触发。

事件：'thermal-state-change' macOS​

返回值

  • details Event<>
    • state string - 系统的新的热状态。可以是 unknown、nominal、fair、serious 或 critical。

系统热状态改变时触发。表示系统热状态发生变化，例如进入了危险温度范围。系统可能会根据严重程度采取措施降低温度，例如限制 CPU 频率或在可用时开启风扇。

应用可以对新的状态做出反应，例如减少耗时的计算任务（如视频编码），或者通知用户。同一个状态可能会重复收到。

参见 https://developer.apple.com/library/archive/documentation/Performance/Conceptual/power_efficiency_guidelines_osx/RespondToThermalStateChanges.html

事件：'speed-limit-change' macOS Windows​

返回值

  • details Event<>
    • limit number - 操作系统公布的 CPU 速度限制，以百分比表示。

通知操作系统公布的 CPU 速度限制发生变化，以百分比表示。小于 100 的值表示系统由于热管理而限制了处理能力。

事件：'shutdown' Linux macOS​

系统即将重启或关机时触发。如果事件处理函数调用 e.preventDefault()，Electron 将尝试延迟系统关机，以便应用程序干净地退出。如果调用了 e.preventDefault()，应用程序应尽快通过调用 app.quit() 之类的方法退出。

事件：'lock-screen' macOS Windows​

系统即将锁定屏幕时触发。

事件：'unlock-screen' macOS Windows​

系统屏幕解锁后立即触发。

事件：'user-did-become-active' macOS​

登录会话激活时触发。参见 文档 了解更多信息。

事件：'user-did-resign-active' macOS​

登录会话停用时触发。参见 文档 了解更多信息。

方法​

`powerMonitor` 模块有以下方法

powerMonitor.getSystemIdleState(idleThreshold)​

  • idleThreshold Integer

返回 string - 系统的当前空闲状态。可以是 active、idle、locked 或 unknown。

计算系统空闲状态。idleThreshold 是被视为空闲所需的时间（以秒为单位）。locked 仅在支持的系统上可用。

powerMonitor.getSystemIdleTime()​

返回 Integer - 空闲时间（秒）

计算系统空闲时间（秒）。

powerMonitor.getCurrentThermalState() macOS​

返回 string - 系统的当前热状态。可以是 unknown、nominal、fair、serious 或 critical。

powerMonitor.isOnBatteryPower()​

返回 boolean - 系统是否在使用电池电源。

要监控此属性的变化，请使用 on-battery 和 on-ac 事件。

属性​

powerMonitor.onBatteryPower​

一个 boolean 属性。如果系统正在使用电池电源，则为 true。

参见 powerMonitor.isOnBatteryPower()。