chrome.power

Description

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

Autorisations

power

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 ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

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