chrome.power

Descripción

Usa la API de chrome.power para anular las funciones de administración de energía del sistema.

Permisos

power

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 el sistema activo.

Con esta API, puedes especificar el nivel en el que se inhabilita la administración de energía. El nivel "system" mantiene activo el sistema, 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 activa la pantalla y el sistema. Por ejemplo, las apps de libros electrónicos y presentaciones 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 energía, se aplica el nivel de mayor prioridad. "display" siempre tiene prioridad sobre "system". Por ejemplo, si la app A solicita la administración de energía "system" y la app B solicita "display", se usa "display" hasta que se descargue la app B o libere su solicitud. Si la app A sigue activa, se usa "system".

Tipos

Level

Enum

"system"
Evita que el sistema entre en suspensión en respuesta a la inactividad del usuario.

"display"
Evita que la pantalla se apague o atenúe, o que el sistema entre en modo de suspensión en respuesta a la inactividad del usuario.

Métodos

releaseKeepAwake()

chrome.power.releaseKeepAwake(): void

Libera una solicitud realizada anteriormente a través de requestKeepAwake().

reportActivity()

Promesa Chrome 113 y versiones posteriores Solo en ChromeOS 
chrome.power.reportActivity(
  callback?: function,
): Promise<void>

Informa una actividad del usuario para activar la pantalla desde un estado atenuado o apagado, o desde un protector de pantalla. Sale del protector de pantalla si está activo.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

requestKeepAwake()

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

Solicita que se inhabilite temporalmente la administración de energía. level describe el grado en que se debe inhabilitar la administración de energía. Si una solicitud realizada anteriormente por la misma app sigue activa, se reemplazará por la nueva.

Parámetros