跳转到主要内容

powerMonitor

监控电源状态更改。

进程：主进程

事件​

powerMonitor 模块会发出以下事件：

事件：'suspend'​

系统暂停时发出。

事件：'resume'​

系统恢复时发出。

事件：'on-ac' macOS Windows​

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

事件：'on-battery' macOS Windows​

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

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

返回

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

当系统的热状态发生变化时发出。通知系统热状态的变化，例如进入临界温度范围。根据严重程度，系统可能会采取措施降低 said 温度，例如限制 CPU 或打开风扇（如果可用）。

应用程序可以根据新状态做出反应，例如减少计算密集型任务（例如视频编码）或通知用户。可能会重复收到相同状态。

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

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

返回

  • details 事件<>
    • 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()。