行動裝置在網路流量中的佔比正持續攀升,其貢獻的流量之龐大,甚至促使我們為行動裝置單獨打造了一批 API 與設計理念。一個相當典型的例子便是 W3C 的電池狀態 API(Battery Status API),它讓應用程式得以得知裝置的電池資訊。本文將帶你探索這個新 API,並說明如何把它整合進現有的應用中。
目前電池 API 尚未獲得主流的廣泛支援,因此在使用前,有必要先確認當前裝置是否支援。下面的函式會回傳一個布林值(True/False),用來指示瀏覽器是否支援電池狀態 API。
該函式首先偵測 navigator.battery 物件是否存在;若不存在,再繼續檢查 Mozilla 專用的 navigator.mozBattery。(我曾看過有些程式碼還會偵測 webkitBattery,但無法證實它在 Chrome 中是否存在。)
參考文件:https://developer.mozilla.org/en-US/docs/DOM/window.navigator.battery
function isBatteryStatusSupported() {
return !!(navigator.battery || navigator.mozBattery);
}
若電池物件存在,它會包含以下四個唯讀屬性:
charging——(布林值)指示系統電池當前是否正在充電。若系統沒有電池,或無法確定是否在充電,回傳 True。
chargingTime——(數值)充滿電所需的時間(秒)。電池已充滿或系統無電池時為 0;若未在充電或無法確定時間,則為 ∞(無窮大)。
dischargingTime——(數值)與 chargingTime 相似,指電池完全放電至系統休眠所剩的時間(秒)。若放電時間無法確定、系統無電池或正在充電,則為 ∞。
level——(數值)裝置當前電量等級,取值介於 0~1.0 之間,對應剩餘電量百分比。1.0 代表已充滿、無電池或數值無法確定。
上述所有屬性都與一個電池事件綁定,這些事件用來指示電池狀態的變化。例如插入電源會讓 charging 屬性從 false 變為 true。四種電池事件如下:
chargingchange——在 charging 屬性改變時觸發,可由 onchargingchange() 事件處理器捕獲。
chargingtimechange——在 chargingTime 屬性改變時觸發,可由 onchargingtimechange() 處理。
dischargingtimechange——在 dischargingTime 屬性改變時觸發,可由 ondischargingtimechange() 處理。
levelchange——在 level 屬性改變時觸發,可由 onlevelchange() 處理。
下面的程式碼示範了如何使用電池狀態 API 的屬性與事件。範例頁面會顯示各屬性的值,並在事件觸發時更新它們。
<!DOCTYPE html>
<html lang="en">
<head>
<title>The Battery Status API - Example</title>
<meta charset="UTF-8"/>
<script>
window.addEventListener("load", function() {
var battery = navigator.battery || navigator.mozBattery;
function displayBatteryStats() {
document.getElementById("charging").textContent = (battery.charging) ? "charging" : "not charging";
document.getElementById("chargingtime").textContent = battery.chargingTime;
document.getElementById("dischargingtime").textContent = battery.dischargingTime;
document.getElementById("level").textContent = battery.level * 100;
}
if (battery) {
displayBatteryStats();
battery.addEventListener("chargingchange", displayBatteryStats, false);
battery.addEventListener("chargingtimechange", displayBatteryStats, false);
battery.addEventListener("dischargingtimechange", displayBatteryStats, false);
battery.addEventListener("levelchange", displayBatteryStats, false);
} else {
document.getElementById("stats").textContent = "Sorry, your browser does not support the Battery Status API";
}
}, false);
</script>
</head>
<body>
<div id="stats">
Your battery is currently <span id="charging"></span>.<br/>
Your battery will be charged in <span id="chargingtime"></span> seconds.<br/>
Your battery will be discharged in <span id="dischargingtime"></span> seconds.<br/>
Your battery level is <span id="level"></span>%.
</div>
</body>
</html>
本文為 Battery Status API 做了一份完整的整理與示範。儘管它仍未獲得主流支援,但這只是時間問題。考慮到行動互聯網的迅猛增長,開發者應該盡快把電池資訊納入設計考量之中。