chrome.power

説明

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

権限

power

コンセプトと使用方法

デフォルトでは、オペレーティング システムはユーザーが非アクティブになると画面が暗くなり、最終的に ありませんPower API を使用すると、アプリや拡張機能でシステムを起動したままにすることができます。

この API を使用すると、電源管理を無効にするレベルを指定できます。"system" レベルに設定すると、システムはアクティブになりますが、画面を暗くしたり、オフにしたりできます。たとえば、 画面がオフになっていても、通信アプリはメッセージを受信できます。"display" レベル 画面とシステムがアクティブな状態を維持します。電子書籍やプレゼンテーション アプリなどでは、 システムがアクティブであることを表します。

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

Level

列挙型

"system"
ユーザーが操作しなかった場合にシステムがスリープ状態にならないようにします。

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

メソッド

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

<ph type="x-smartling-placeholder"></ph> 約束 Chrome 113 以降 ChromeOS のみ
chrome.power.reportActivity(
  callback?: function,
)

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

パラメータ

  • callback

    関数(省略可)

    callback パラメータは次のようになります。

    () => void

戻り値

  • 約束 <void>

    Promise は Manifest V3 以降でサポートされていますが、 下位互換性が確保されます同じ関数呼び出しで両方を使用することはできません。「 Promise はコールバックに渡された型と同じ型で解決されます。

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

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

パラメータ