说明
使用 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()
chrome.power.reportActivity(
callback?: function,
)
报告用户活动,以便从暗淡或关闭的状态或屏保中唤醒屏幕。退出屏保(如果目前处于活动状态)。
参数
-
callback
函数(可选)
callback
参数如下所示:() => void
返回
-
Promise<void>
Manifest V3 及更高版本支持 promise,但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
)
请求暂时停用电源管理功能。level
描述应停用电源管理功能的程度。如果同一应用之前发出的请求仍处于活跃状态,系统会将其替换为新请求。
参数
-
level