browser.power

説明

chrome.power API を使用して、システムの電源管理機能をオーバーライドします。

権限

power

コンセプトと使用方法

デフォルトでは、オペレーティング システムは、ユーザーが操作を行わないと画面を暗くし、最終的にシステムを一時停止します。Power API を使用すると、アプリや拡張機能でシステムをスリープ状態にしないようにすることができます。

この API を使用して、電源管理を無効にするレベルを指定できます。"system" レベルでは、システムはアクティブなままですが、画面を暗くしたりオフにしたりできます。たとえば、通信アプリは画面がオフの間もメッセージを受信し続けることができます。"display" レベルでは、画面とシステムがアクティブなままになります。たとえば、電子書籍アプリやプレゼンテーション アプリでは、ユーザーが読んでいる間、画面とシステムをアクティブに保つことができます。

ユーザーが複数のアプリまたは拡張機能を有効にしていて、それぞれに独自の電源レベルが設定されている場合は、最も優先度の高いレベルが有効になります。"display" は常に "system" よりも優先されます。たとえば、アプリ A が "system" の電源管理をリクエストし、アプリ B が "display" をリクエストした場合、アプリ B がアンロードされるかリクエストを解放するまで "display" が使用されます。アプリ A がまだアクティブな場合は、"system" が使用されます。

型

Level

列挙型

"system"
ユーザーが操作を行わなくても、システムがスリープ状態にならないようにします。

"display"
ユーザーが操作していないときに、ディスプレイがオフになったり、暗くなったり、システムがスリープ状態になったりしないようにします。

メソッド

releaseKeepAwake()

browser.power.releaseKeepAwake(): void

以前に requestKeepAwake() を介して行われたリクエストを解放します。

reportActivity()

Chrome 113 以降 Chrome 148 以降の browser.* ChromeOS のみ 
browser.power.reportActivity(): Promise<void>

画面が暗くなっている状態、オフになっている状態、またはスクリーンセーバーの状態から復帰させるために、ユーザー アクティビティを報告します。スクリーンセーバーが現在有効になっている場合は、スクリーンセーバーを終了します。

戻り値

  • Promise<void>

requestKeepAwake()

browser.power.requestKeepAwake(
  level: Level,
): void

電源管理を一時的に無効にするようリクエストします。level は、電源管理を無効にする程度を表します。同じアプリによって以前に作成されたリクエストがまだ有効な場合は、新しいリクエストに置き換えられます。

パラメータ