Descripción
Usa la API de chrome.power
para anular las funciones de administración de batería del sistema.
Permisos
power
Conceptos y uso
De forma predeterminada, los sistemas operativos atenúan la pantalla cuando los usuarios están inactivos y, finalmente, suspenden el sistema. Con la API de Power, una app o extensión puede mantener activo el sistema.
Con esta API, puedes especificar el Level en el que se inhabilita la administración de energía. El nivel "system"
mantiene el sistema activo, pero permite que la pantalla se atenúe o se apague. Por ejemplo, una app de comunicación puede seguir recibiendo mensajes mientras la pantalla está apagada. El nivel "display"
mantiene la pantalla y el sistema activos. Las apps de libros electrónicos y presentaciones, por ejemplo, pueden mantener la pantalla y el sistema activos mientras los usuarios leen.
Cuando un usuario tiene más de una app o extensión activa, cada una con su propio nivel de potencia, se aplica el nivel de precedencia más alto. "display"
siempre tiene prioridad sobre "system"
. Por ejemplo, si la app A solicita administración de energía de "system"
y la app B solicita "display"
, se usa "display"
hasta que se descargue la app B o lance su solicitud. Si la app A aún está activa, se usa "system"
.
Tipos
Level
Enum
"system"
Evita que el sistema se suspenda en respuesta a la inactividad del usuario.
"display"
Evita que se apague o atenúe la pantalla, o que el sistema se suspenda en respuesta a la inactividad del usuario.
Métodos
releaseKeepAwake()
chrome.power.releaseKeepAwake()
Libera una solicitud realizada anteriormente mediante requestKeepAwake().
reportActivity()
chrome.power.reportActivity(
callback?: function,
)
Informa una actividad del usuario para activar la pantalla desde un estado atenuado o desactivado, o desde un protector de pantalla. Cierra el protector de pantalla si está activo.
Parámetros
-
callback
Función opcional
El parámetro
callback
se ve de la siguiente manera:() => void
Devuelve
-
Promise<void>
Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.
requestKeepAwake()
chrome.power.requestKeepAwake(
level: Level,
)
Solicita que se inhabilite temporalmente la administración de energía. level
describe el grado en el que se debe inhabilitar la administración de energía. Si una solicitud previamente realizada por la misma app sigue activa, se reemplazará por la solicitud nueva.
Parámetros
-
level