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
|
---
title: Battery Status API
slug: Web/API/Battery_Status_API
tags:
- API
- Apps
- Batería
- Firefox OS
- Guia(2)
- Guía
- Mobile
- Obsoleto
translation_of: Web/API/Battery_Status_API
original_slug: WebAPI/Battery_Status
---
<div>{{obsolete_header}}</div>
<div>{{DefaultAPISidebar("Battery API")}}</div>
<p>A <strong>API Battery Status</strong>, mais conhecida como <strong>Battery API</strong>, fornece informações sobre o nível de carga da bateria presente no sistema e permite que você seja notificado por eventos que são enviados quando os níveis sofrem alterações. Isto pode ser usado para ajustar a utilização de recursos do seu aplicativo, reduzindo a quantidade de energia drenada por ele quando a bateria estiver em nível baixo, ou ainda para salvar mudanças antes da bateria acabar, prevenindo a perda de dados.</p>
<p>A API Battery Status API estende {{domxref("Window.navigator")}} com uma propriedade {{domxref("Navigator.battery")}} que é um objeto {{domxref("BatteryManager")}}, e adiciona alguns novos eventos que você pode receber para monitorar o status da bateria.</p>
<h2 id="Exemplo">Exemplo</h2>
<p>Neste exemplo, nós observamos as mudanças em ambos os status de carregamento (se estamos ou não conectados e carregando) e para mudanças no nível da bateria. Isto é feito escutando pelos eventos {{event("chargingchange")}} e {{event("levelchange")}}, respectivamente.</p>
<pre class="brush: js">var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery;
function updateBatteryStatus() {
console.log("Status da bateria: " + battery.level * 100 + " %");
if (battery.charging) {
console.log("A bateria está carregando");
}
}
battery.addEventListener("chargingchange", updateBatteryStatus);
battery.addEventListener("levelchange", updateBatteryStatus);
updateBatteryStatus();
</pre>
<p>Veja também <a class="external" href="http://dev.w3.org/2009/dap/system-info/battery-status.html#introduction">o exemplo na especificação</a>.</p>
<h2 id="Especificações">Especificações</h2>
<p>{{page("/pt-BR/docs/Web/API/BatteryManager","Specifications")}}</p>
<h2 id="Compatibilidade_entre_navegadores">Compatibilidade entre navegadores</h2>
<p>{{page("/pt-BR/docs/Web/API/BatteryManager","Browser_compatibility")}}</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li><a class="external" href="http://hacks.mozilla.org/2012/02/using-the-battery-api-part-of-webapi/">Hacks blog post - Usando a API Battery API (em inglês)</a></li>
<li>{{domxref("BatteryManager")}}</li>
<li>{{domxref("Navigator.battery","navigator.battery")}}</li>
</ul>
|
