PowerManager

Non standard
Cette fonctionnalité n'est pas en voie de standardisation au W3C, mais elle est supportée par la plateforme Firefox OS. Bien que son implémentation puisse changer dans le futur et qu'elle n'est pas largement supportée par les différents navigateurs, elle est utilisable pour du code dédié aux applications Firefox OS.

Cette API est disponible sur Firefox OS pour des applications internes seulement.

L'interface PowerManager permet de contrôler explicitement les composants de l'appareil consommant de l'énergie.

Présentation de l'interface

callback wakeLockListener = void (DOMString topic, DOMString state);

interface PowerManager
{
  attribute boolean cpuSleepAllowed
  attribute double screenBrightness
  attribute boolean screenEnabled

  void addWakeLockListener(wakeLockListener listener);
  void factoryReset();
  DOMString getWakeLockState(DOMString topic)
  void powerOff();
  void reboot();
  void removeWakeLockListener(wakeLockListener listener);  
};

Propriétés

PowerManager.screenEnabled: Cette propriété est un booléen permettant de consulter ou définir l'état de l'écran de l'appareil. true correspond à un écran actif false à un écran éteint.
PowerManager.screenBrightness: Cette propriété définit la luminosité du rétro-éclairage de l'écran sur une échelle de 0 (min) à 1 (max). Définir cet attribut modifie la luminosité de l'écran.
PowerManager.cpuSleepAllowed: Cette propriété détermine si le processeur de l'appareil passera en veille après l'extinction de l'écran. Définir cet attribut à false inhibe la mise en veille du processeur de l'appareil.

Méthodes

PowerManager.addWakeLockListener(): Enregistre un gestionnaire d'événements qui sera appelé à chaque changement d'état par rapport à la mise en veille de la ressource donnée.
PowerManager.factoryReset(): Appeler cette méthode reconfigure l'appareil dans sa configuration usine (toutes les données utilisateurs seront perdues).
PowerManager.getWakeLockState(): Retourne l'état de verrouillage d'une ressource donnée de l'appareil.
PowerManager.powerOff(): Appeler cette méthode éteint l'appareil.
PowerManager.reboot(): Cette méthode éteint l'appareil et le redémarre.
PowerManager.removeWakeLockListener(): Permet de retirer un gestionnaire d'événements défini précédemment avec addWakeLockListener.

Exemple

var screenTimeout;
var power = window.navigator.mozPower;
var powerAction = {
  unlocked: function suspendDevice() {
    power.cpuSleepAllowed = true;
    power.screenEnabled   = false;
  },

  'locked-background': function shutOffOnlyScreen() {
    power.cpuSleepAllowed = false;
    power.screenEnabled   = false;
  }
}

function screenLockListener(topic, state) {
  if ('screen' !== topic) return;

  window.clearTimeout(screenTimeout);

  if (powerAction[state]) {
    screenTimeout = window.setTimeout(powerAction[state], 3000);
  }
}

power.addWakeLockListener(screenLockListener);

Spécification

Cette API ne fait partie d'aucune spécification.