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 la transmisión. en un sistema de archivos. Con la Power API, 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 batería. El "system" mantiene el sistema activo, pero permite que la pantalla se atenúe o se apague. Por ejemplo, un La app de comunicación podrá 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 activo mientras los usuarios leen.

Cuando un usuario tiene más de una app o extensión activas, cada una con su propio nivel de potencia, el se aplica el nivel de precedencia más alto; "display" siempre tiene prioridad sobre "system". Para Por ejemplo, si la app A solicita la administración de energía "system" y la app B solicita "display", la app B solicita "display", se usa hasta que se descarga la app B o lanza su solicitud. Si la app A sigue activa, "system" luego se usará.

Tipos

Level

Enum

"system"
Impide que se suspenda el sistema en respuesta a la inactividad del usuario.

"display"
Evita que la pantalla se apague o se atenúe, 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 en ChromeOS .
chrome.power.reportActivity(
  callback?: function,
)

Informa la actividad del usuario para activar la pantalla si está atenuada o apagada, o si usa 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

  • Promesa<void>

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El 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 batería. level describe el grado en el que se debe inhabilitar la administración de energía. Si una solicitud anterior que realizó la misma app sigue activa, se reemplazará por la solicitud nueva.

Parámetros