blob: 184b07310f18e22df8066217fb31d512ca0b14bf (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
---
title: PowerManager
slug: Web/API/PowerManager
tags:
- API
- B2G
- Firefox OS
- Non-standard
- Power Management
- Reference
- WebAPI
translation_of: Archive/B2G_OS/API/MozPowerManager
---
<p>{{ ApiRef() }}</p>
<p>{{ non-standard_header() }}</p>
<p>{{ B2GOnlyHeader2('certified') }}</p>
<p>L'interface PowerManager permet de contrôler explicitement les composants de l'appareil consommant de l'énergie.</p>
<h2 id="Présentation_de_l'interface">Présentation de l'interface</h2>
<pre class="brush: js"><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étés">Propriétés</h2>
<dl>
<dt>
{{domxref("PowerManager.screenEnabled")}}</dt>
<dd>
Cette propriété est un booléen permettant de consulter ou définir l'état de l'écran de l'appareil. <code>true</code> correspond à un écran actif <code>false</code> à un écran éteint.</dd>
<dt>
{{domxref("PowerManager.screenBrightness")}}</dt>
<dd>
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.</dd>
<dt>
{{domxref("PowerManager.cpuSleepAllowed")}}</dt>
<dd>
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 à <code>false</code> inhibe la mise en veille du processeur de l'appareil.</dd>
</dl>
<h2 id="Méthodes">Méthodes</h2>
<dl>
<dt>
{{domxref("PowerManager.addWakeLockListener()")}}</dt>
<dd>
Enregistre un gestionnaire d'événements qui sera appelé à chaque changement d'état par rapport à la mise en veille de la ressource donnée.</dd>
<dt>
{{domxref("PowerManager.factoryReset()")}}</dt>
<dd>
Appeler cette méthode reconfigure l'appareil dans sa configuration usine (toutes les données utilisateurs seront perdues).</dd>
<dt>
{{domxref("PowerManager.getWakeLockState()")}}</dt>
<dd>
Retourne l'état de verrouillage 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 le redémarre.</dd>
<dt>
{{domxref("PowerManager.removeWakeLockListener()")}}</dt>
<dd>
Permet de retirer un gestionnaire d'événements défini 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>Cette API 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>
|