powerMonitor

监控电源状态的变化。

进程：主进程

事件

powerMonitor 模块会发出以下事件

事件：'suspend'

当系统挂起时发出。

事件：'resume'

当系统恢复时发出。

事件：'on-ac' macOS Windows

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

事件：'on-battery' macOS Windows

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

事件：'thermal-state-change' macOS

返回

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