chrome.power

说明

使用 chrome.power API 替换系统的电源管理功能。

权限

power

用法

默认情况下，当用户不活动时，操作系统会调暗屏幕，并最终暂停 系统。借助 Power API，应用或扩展程序可使系统保持唤醒状态。

使用此 API，您可以指定要停用电源管理的 Level。"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>

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

请求暂时停用电源管理。level 表示应停用电源管理的程度。如果同一应用之前发出的请求仍然有效，将被新的请求所取代。

参数