説明
システムの電源管理機能をオーバーライドするには、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 以降でサポートされていますが、コールバックは下位互換性のために提供されています。同じ関数呼び出しで両方を使用することはできません。Promise は、コールバックに渡されたのと同じ型で解決されます。
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
)
電源管理を一時的に無効にすることをリクエストします。level は、電源管理を無効にするレベルを指定します。同じアプリから以前に行われたリクエストがまだアクティブな場合は、新しいリクエストに置き換えられます。
パラメータ
-
level