跳到主要内容

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()。