powerMonitor API 列表

本模块包含 16 个 API。

Events(事件)

API 说明 鸿蒙支持
suspend 在系统进入休眠时触发。 支持
resume 在系统从休眠中恢复时触发。 支持
on-ac 在系统切换至交流电供电时触发。 不支持
on-battery 在系统切换至电池供电时触发。 不支持
thermal-state-change 在系统热状态发生变化时触发,例如进入临界温度区间。 不支持
speed-limit-change 在操作系统通告的 CPU 速度限制发生变化时触发,数值低于 100 表示系统因热管理限制了处理能力。 不支持
shutdown 在系统即将重启或关机时触发。若事件处理器调用 e.preventDefault(),Electron 将尝试延迟系统关机以便应用正常退出。 不支持
lock-screen 在系统即将锁定屏幕时触发。 不支持
unlock-screen 在系统屏幕解锁后立即触发。 不支持
user-did-become-active 在登录会话被激活时触发,详情参见相关文档。 不支持
user-did-resign-active 在登录会话停用时触发,详情参见相关文档。 不支持

Methods(方法)

API 说明 鸿蒙支持
powerMonitor.getSystemIdleState(idleThreshold) 返回 string,表示系统当前的空闲状态,可为 active、idle、locked 或 unknown。 支持
powerMonitor.getSystemIdleTime() 返回 Integer,表示系统空闲时间(秒)。 支持
powerMonitor.getCurrentThermalState() 返回 string,表示系统当前热状态,可为 unknown、nominal、fair、serious 或 critical。 不支持
powerMonitor.isOnBatteryPower() 返回 boolean,表示系统当前是否使用电池供电。 支持

Properties(属性)

API 说明 鸿蒙支持
powerMonitor.onBatteryPower 布尔属性,若系统正在使用电池供电则为 true。 支持