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()

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

报告用户活动，以便从暗淡或关闭的状态或屏保中唤醒屏幕。退出屏保（如果目前处于活动状态）。

参数

  • callback

    函数（可选）

    callback 参数如下所示：

    ()=>void

返回

  • Promise<void>

    Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

请求暂时停用电源管理功能。level 描述应停用电源管理功能的程度。如果同一应用之前发出的请求仍处于活跃状态，系统会将其替换为新请求。

参数