メインコンテンツにスキップ

powerMonitor

電源状態の変化を監視します。

プロセス: メイン

イベント

powerMonitor モジュールは、次のイベントを発行します。

イベント: 'suspend'

システムがサスペンドしているときに発行されます。

イベント: 'resume'

システムが再開しているときに発行されます。

イベント: 'on-ac' macOS Windows

システムがAC電源に切り替わったときに発行されます。

イベント: '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 整数

string を返します - システムの現在のアイドル状態。activeidlelockedunknown のいずれかになります。。

システムのアイドル状態を計算します。idleThreshold は、アイドル状態と見なされるまでの時間(秒単位)です。locked は、サポートされているシステムでのみ利用可能です。

powerMonitor.getSystemIdleTime()

Integer を返します - アイドル時間(秒単位)

システムのアイドル時間を秒単位で計算します。

powerMonitor.getCurrentThermalState() macOS

string を返します - システムの現在の熱状態。unknownnominalfairseriouscritical のいずれかになります。

powerMonitor.isOnBatteryPower()

boolean を返します - システムがバッテリー電源を使用しているかどうか。

このプロパティの変更を監視するには、on-battery イベントと on-ac イベントを使用します。

プロパティ

powerMonitor.onBatteryPower

boolean プロパティ。システムがバッテリー電源を使用している場合は true。

powerMonitor.isOnBatteryPower() を参照してください。