chrome.power

说明

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

权限

power

概念和用法

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

使用此 API，您可以指定停用电源管理的级别。"system" 级别可让系统保持活跃状态，但允许屏幕变暗或关闭。例如，即使屏幕处于关闭状态，通信应用也可以继续接收消息。"display" 级别可让屏幕和系统保持活跃状态。例如，电子书应用和演示应用可以在用户阅读时保持屏幕和系统处于活动状态。

当用户同时运行多个应用或扩展程序时，每个应用或扩展程序都有自己的能耗级别，此时系统会采用优先级最高的级别；"display" 的优先级始终高于 "system"。例如，如果应用 A 请求 "system" 电源管理，而应用 B 请求 "display"，则在应用 B 卸载或释放其请求之前，系统会使用 "display"。如果应用 A 仍处于活跃状态，则使用 "system"。

类型

Level

枚举

“system”
防止系统因用户不活动而进入休眠状态。

“display”
防止显示屏因用户不活动而关闭或变暗，或防止系统进入休眠状态。

方法

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

释放之前通过 requestKeepAwake() 发出的请求。

reportActivity()

Promise Chrome 113 及更高版本 仅限 ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

报告用户活动，以便从屏幕变暗或关闭状态或从屏保唤醒屏幕。如果屏保当前处于活动状态，则退出屏保。

参数

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

requestKeepAwake()

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

请求暂时停用电源管理。level 描述了应停用电源管理的程度。如果同一应用之前发出的请求仍处于有效状态，则会被新请求替换。

参数