chrome.power

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

Promesa Chrome 113 y versiones posteriores Solo para ChromeOS 
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