跳至主要内容

powerMonitor

监控电源状态变化。

进程: 主进程

事件

powerMonitor 模块发出以下事件

事件: 'suspend'

当系统进入睡眠状态时发出。

事件: 'resume'

当系统恢复时发出。

事件: 'on-ac' macOS Windows

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

事件: 'on-battery' macOS Windows

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

事件: 'thermal-state-change' macOS

  • state 字符串 - 系统的新热状态。可以是 unknownnominalfairseriouscritical

当系统的热状态发生变化时发出。通知系统热状态的改变,例如进入临界温度范围。根据严重程度,系统可能会采取措施来降低该温度,例如节流 CPU 或打开风扇(如果可用)。

应用程序可以通过减少昂贵的计算任务(例如视频编码)或通知用户来对新状态做出反应。可能会重复收到相同的状态。

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

事件: 'speed-limit-change' macOS Windows

  • 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 整数

返回值 字符串 - 系统的当前空闲状态。可以是 activeidlelockedunknown

计算系统空闲状态。idleThreshold 是在被视为空闲之前的时间量(以秒为单位)。locked 仅在支持的系统上可用。

powerMonitor.getSystemIdleTime()

返回值 整数 - 空闲时间(以秒为单位)

计算系统空闲时间(以秒为单位)。

powerMonitor.getCurrentThermalState() macOS

返回值 字符串 - 系统的当前热状态。可以是 unknownnominalfairseriouscritical

powerMonitor.isOnBatteryPower()

返回值 布尔值 - 系统是否处于电池供电状态。

若要监控此属性的变化,请使用 on-batteryon-ac 事件。

属性

powerMonitor.onBatteryPower

布尔值 属性。如果系统处于电池供电状态,则为真。

参见 powerMonitor.isOnBatteryPower().