powerMonitor

监测电源状态变化。

进程：主进程

事件

powerMonitor 模块发出以下事件

事件：'suspend'

当系统挂起时触发。

事件：'resume'

当系统恢复时触发。

事件：'on-ac' macOS Windows

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

事件：'on-battery' macOS Windows

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

事件：'thermal-state-change' macOS

返回值

• details Event<>
  • state 字符串 - 系统的最新热状态。可以是 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 数字 - 操作系统为 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 整型

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