説明
システムの電源管理機能をオーバーライドするには、chrome.power
API を使用します。
権限
power
用途
デフォルトでは、オペレーティング システムはユーザーがアクティブでないときに画面を暗くし、最終的にシステムを一時停止します。Power API を使用すると、アプリまたは拡張機能でシステムを起動したままにすることができます。
この API を使用して、電源管理を無効にする Level を指定できます。"system"
レベルの場合、システムはアクティブなままですが、画面を暗くしたり、オフにしたりすることもできます。たとえば、通信アプリは画面がオフになっていても、引き続きメッセージを受信できます。"display"
レベルの場合、画面とシステムがアクティブなままになります。たとえば、電子書籍やプレゼンテーション アプリでは、ユーザーが本を読んでいる間、画面とシステムをアクティブに保つことができます。
ユーザーが複数のアプリまたは拡張機能をアクティブにし、それぞれが独自の電力レベルを持っている場合、最も高い優先順位が有効になります。"display"
は常に "system"
よりも優先されます。たとえば、アプリ A が "system"
電源管理を要求し、アプリ B が "display"
を要求した場合、アプリ B がアンロードされるか、そのリクエストを解放するまで、"display"
が使用されます。アプリ A がまだアクティブな場合は、"system"
が使用されます。
型
Level
Enum
"system"
ユーザーの操作がなかった場合にシステムがスリープしないようにします。
"display"
ユーザーが操作しなくてもディスプレイがオフになったり、暗くなったりしたり、システムがスリープしたりしないようにします。
Methods
releaseKeepAwake()
chrome.power.releaseKeepAwake()
以前に requestKeepAwake() で行われたリクエストを解放します。
reportActivity()
chrome.power.reportActivity(
callback?: function,
)
グレー表示やオフの状態から、あるいはスクリーンセーバーから画面を復帰させるためのユーザー アクティビティを報告します。スクリーンセーバーが現在アクティブな場合は、終了します。
パラメータ
-
callback
関数(省略可)
callback
パラメータは次のようになります。() => void
戻り値
-
Promise<void>
Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
)
電源管理を一時的に無効にすることをリクエストします。level
は、電源管理を無効にするレベルを指定します。同じアプリから以前に行われたリクエストがまだアクティブな場合は、新しいリクエストに置き換えられます。
パラメータ
-
level