chrome.power

Description

Utilisez l'API chrome.power pour ignorer les fonctionnalités de gestion de l'alimentation du système.

Autorisations

power

Concepts et utilisation

Par défaut, les systèmes d'exploitation réduisent la luminosité de l'écran lorsque les utilisateurs sont inactifs et suspendent le système à terme. Avec l'API Power, une application ou une extension peut maintenir le système actif.

Cette API vous permet de spécifier le niveau auquel la gestion de l'alimentation est désactivée. Le niveau "system" maintient le système actif, mais permet d'assombrir ou d'éteindre l'écran. Par exemple, une application de communication peut continuer à recevoir des messages lorsque l'écran est éteint. Le niveau "display" permet de maintenir l'écran et le système actifs. Les applications de livres numériques et de présentations, par exemple, peuvent maintenir l'écran et le système actifs pendant que les utilisateurs lisent.

Lorsqu'un utilisateur a plusieurs applications ou extensions actives, chacune avec son propre niveau de puissance, le niveau de priorité le plus élevé prend effet. "display" est toujours prioritaire sur "system". Par exemple, si l'application A demande la gestion de l'alimentation "system" et que l'application B demande "display", "display" est utilisé jusqu'à ce que l'application B soit déchargée ou libère sa requête. Si l'application A est toujours active, "system" est alors utilisé.

Types

Level

Enum

"system"
Empêche le système de se mettre en veille en réponse à l'inactivité de l'utilisateur.

"display"
Empêche l'extinction ou la luminosité de l'écran, ou la mise en veille du système suite à l'inactivité de l'utilisateur.

Méthodes

releaseKeepAwake()

chrome.power.releaseKeepAwake()

Diffuse une requête précédemment effectuée via requestKeepAwake().

reportActivity()

Promettre Chrome 113 et versions ultérieures ChromeOS uniquement 
chrome.power.reportActivity(
  callback?: function,
)

Signale une activité d'un utilisateur visant à réactiver l'écran lorsque la luminosité est réduite ou éteinte, ou à partir d'un économiseur d'écran. Quitte l'économiseur d'écran s'il est actif.

Paramètres

  • rappel

    fonction facultative

    Le paramètre callback se présente comme suit : 

    ()=>void

Renvoie

  • Promise<void>

    Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

requestKeepAwake()

chrome.power.requestKeepAwake(
  level: Level,
)

Demande la désactivation temporaire de la gestion de l'alimentation. level indique dans quelle mesure la gestion de l'alimentation doit être désactivée. Si une requête précédemment effectuée par la même application est toujours active, elle est remplacée par la nouvelle requête.

Paramètres