powerMonitor
電源状態の変化を監視します。
プロセス: メイン
イベント
powerMonitor
モジュールは、次のイベントを発行します。
イベント: 'suspend'
システムがサスペンドしているときに発行されます。
イベント: 'resume'
システムが再開しているときに発行されます。
イベント: 'on-ac' macOS Windows
システムがAC電源に切り替わったときに発行されます。
イベント: 'on-battery' macOS Windows
システムがバッテリー電源に切り替わったときに発行されます。
イベント: 'thermal-state-change' macOS
state
文字列 - システムの新しい熱状態。unknown
、nominal
、fair
、serious
、critical
のいずれかになります。
システムの熱状態が変化したときに発行されます。臨界温度範囲への突入など、システムの熱状態の変化の通知。重大度に応じて、システムは温度を下げるための措置を講じる可能性があります。たとえば、CPUをスロットリングしたり、利用可能な場合はファンをオンにしたりします。
アプリは、高コストなコンピューティングタスク(ビデオエンコードなど)を削減したり、ユーザーに通知したりすることで、新しい状態に対応できます。同じ状態が繰り返し受信されることがあります。
イベント: '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
整数
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()
を参照してください。