跳到主要內容

powerMonitor

監控電源狀態變更。

程序：主程序

事件​

powerMonitor 模組發射以下事件

事件：'suspend'​

當系統暫停時發射。

事件：'resume'​

當系統恢復時發射。

事件：'on-ac' macOS Windows​

當系統切換至 AC 電源時發射。

事件：'on-battery' macOS Windows​

當系統切換至電池電源時發射。

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

回傳

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