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 finissent par suspendre l'accès du système d'exploitation. Avec l'API Power, une application ou une extension peut maintenir le système activé.

Cette API vous permet d'indiquer le niveau pour lequel la gestion de l'alimentation est désactivée. "system" maintient le système actif, mais permet d'assombrir ou d'éteindre l'écran. Par exemple, un application de communication peut continuer à recevoir des messages lorsque l'écran est éteint. Niveau "display" maintient l'écran et le système actifs. Les applications d'e-books ou de présentations, par exemple, peuvent conserver l'écran et le système actif 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" prévaut toujours sur "system". Pour Exemple : si l'application A demande la gestion de l'alimentation "system", et que l'application B demande "display", "display" est utilisée jusqu'à ce que l'application B soit déchargée ou libère sa requête. Si l'application A est toujours active, "system" l'est puis utilisées.

Types

Level

Énumération

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

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

Méthodes

releaseKeepAwake()

chrome.power.releaseKeepAwake()

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

reportActivity()

<ph type="x-smartling-placeholder"></ph> Promesse Chrome 113 et versions ultérieures ChromeOS uniquement 
chrome.power.reportActivity(
  callback?: function,
)

Signale l'activité d'un utilisateur dans le but de réactiver l'écran lorsqu'il est éteint ou assombri, ou lorsqu'il utilise un économiseur d'écran. Quitter l'économiseur d'écran s'il est actif

Paramètres

  • rappel

    function facultatif

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

    () => void

Renvoie

  • Promesse<void>

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La 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 envoyée par la même application est toujours active, elle est remplacée par la nouvelle requête.

Paramètres