PowerManager

  • Raccourci de la révision : Web/API/PowerManager
  • Titre de la révision : PowerManager
  • ID de la révision : 434307
  • Créé :
  • Créateur : darnuria
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

{{ non-standard_header() }}

{{ B2GOnlyHeader2('certified') }}

L'interface PowerManager permet de contrôler explicitement les ressources matérielles consommant de l'énergie.

Interface vue générale

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

{{domxref("PowerManager.screenEnabled")}}
Cette propriété est un booléen permettant de consulté ou définir l'état de l'écran de l'appareil. (True) correspond à un écran actif (False) éteint.
{{domxref("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 attribue modifie la luminosité de l'écran.
{{domxref("PowerManager.cpuSleepAllowed")}}
Cette propriété détermine si le processeur de l'appareil peut entrer  suspend après que l'écran soit éteint. Définir cet attribut à (false) inhibe la mise en suspend du processeur de l'appareil.

Méthodes

{{domxref("PowerManager.addWakeLockListener()")}}
Enregistre un gestionnaire qui sera appelé à chaque changement d'état par rapport à la mise en veille pour la ressource donnée.
{{domxref("PowerManager.factoryReset()")}}
Appeler cette méthode remet à l'état d'usine, l'appareil.(Toute les données utilisateurs seront perdues.)
{{domxref("PowerManager.getWakeLockState()")}}
Retourne l'état courant de "lock" d'une ressource donnée de l'appareil.
{{domxref("PowerManager.powerOff()")}}
Appeler cette méthode éteint l'appareil.
{{domxref("PowerManager.reboot()")}}
Cette méthode éteint l'appareil et boot l'appareil.
{{domxref("PowerManager.removeWakeLockListener()")}}
Permet de retirer un gestionnaire définit précédemment avec {{domxref("PowerManager.addWakeLockListener()","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

Ne fait partie d'aucune spécification.

Voir aussi

  • {{ domxref("window.navigator.mozPower","navigator.mozPower") }}
  • {{ domxref("window.navigator.requestWakeLock()","navigator.requestWakeLock()") }}

Source de la révision

<!-- <p>{{ domref() }}</p> -->
<p>{{ non-standard_header() }}</p>
<p>{{ B2GOnlyHeader2('certified') }}</p>
<p>L'interface PowerManager permet de contrôler explicitement les ressources matérielles consommant de l'énergie.</p>
<h2 id="Interface_vue_g.C3.A9n.C3.A9rale">Interface vue générale</h2>
<pre>
<code class="idl-code">callback wakeLockListener = void (DOMString topic, DOMString state);</code>

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);  
};</pre>
<h2 id="Propri.C3.A9t.C3.A9s">Propriétés</h2>
<dl>
  <dt>
    {{domxref("PowerManager.screenEnabled")}}</dt>
  <dd>
    Cette propriété est un booléen permettant de consulté ou définir l'état de l'écran de l'appareil. (True) correspond à un écran actif (False) éteint.</dd>
  <dt>
    {{domxref("PowerManager.screenBrightness")}}</dt>
  <dd>
    Cette propriété définit la luminosité du rétro-éclairage de l'écran,<br />
    sur une échelle de 0(min) à 1(max). Définir cet attribue modifie la luminosité de l'écran.</dd>
  <dt>
    {{domxref("PowerManager.cpuSleepAllowed")}}</dt>
  <dd>
    Cette propriété détermine si le processeur de l'appareil peut entrer&nbsp; suspend après que l'écran soit éteint. Définir cet attribut à (false) inhibe la mise en suspend du processeur de l'appareil.</dd>
</dl>
<h2 id="M.C3.A9thodes">Méthodes</h2>
<dl>
  <dt>
    {{domxref("PowerManager.addWakeLockListener()")}}</dt>
  <dd>
    Enregistre un gestionnaire qui sera appelé à chaque changement d'état par rapport à la mise en veille pour la ressource donnée.</dd>
  <dt>
    {{domxref("PowerManager.factoryReset()")}}</dt>
  <dd>
    Appeler cette méthode remet à l'état d'usine, l'appareil.(Toute les données utilisateurs seront perdues.)</dd>
  <dt>
    {{domxref("PowerManager.getWakeLockState()")}}</dt>
  <dd>
    Retourne l'état courant de "lock" d'une ressource donnée de l'appareil.</dd>
  <dt>
    {{domxref("PowerManager.powerOff()")}}</dt>
  <dd>
    Appeler cette méthode éteint l'appareil.</dd>
  <dt>
    {{domxref("PowerManager.reboot()")}}</dt>
  <dd>
    Cette méthode éteint l'appareil et boot l'appareil.</dd>
  <dt>
    {{domxref("PowerManager.removeWakeLockListener()")}}</dt>
  <dd>
    Permet de retirer un gestionnaire définit précédemment avec {{domxref("PowerManager.addWakeLockListener()","addWakeLockListener")}}.</dd>
</dl>
<h2 id="Specification" name="Specification">Exemple</h2>
<pre class="brush: js">
var screenTimeout;
var power = window.navigator.mozPower;
var powerAction = {
  unlocked: function suspendDevice() {
    power.<code>cpuSleepAllowed = true;</code>
    power.screenEnabled   = false;
  },

  'locked-background': function shutOffOnlyScreen() {
    power.<code>cpuSleepAllowed = false;</code>
    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);
</pre>
<h2 id="Specification" name="Specification">Spécification</h2>
<p>Ne fait partie d'aucune spécification.</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
  <li>{{ domxref("window.navigator.mozPower","navigator.mozPower") }}</li>
  <li>{{ domxref("window.navigator.requestWakeLock()","navigator.requestWakeLock()") }}</li>
</ul>
Revenir à cette révision