DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 電池狀態 API:讀取電量、充放電時間與事件監聽
編輯:HTML5詳解     

行動裝置佔比一路攀升,為了他們,業界甚至專門設計了一批 API 與設計準則。W3C 的 Battery Status API 就是很典型的例子:它讓網頁能讀取裝置的電池資訊,據此調整行為,例如低電量時關掉動畫、停止輪詢。本文帶你看這個 API 怎麼用、怎麼整合進既有專案。

先確認瀏覽器是否支援

這個 API 的支援度一直不算完整,所以第一步永遠是特性檢測。早期版本透過 navigator.battery 讀取,Firefox 曾用前綴寫法 navigator.mozBattery;後來標準改為非同步的 navigator.getBattery(),回傳 Promise。撰寫時建議三種都試,取到哪個用哪個。

function getBattery() {
  if (navigator.getBattery) return navigator.getBattery();          // 現行標準
  if (navigator.battery) return Promise.resolve(navigator.battery); // 舊版
  if (navigator.mozBattery) return Promise.resolve(navigator.mozBattery);
  return Promise.resolve(null);                                     // 不支援
}

需要注意的是,近年部分瀏覽器基於隱私與防指紋追蹤的考量,已經收緊甚至移除了這項能力。因此務必保留降級路徑:拿不到電池資訊時,應用程式要照常運作。

四個唯讀屬性

  • charging(布林):目前是否正在充電。若裝置沒有電池,或無法判定,回傳 true。
  • chargingTime(數值):充飽所需的秒數。充滿或無電池時為 0;未充電或無法估算時為 Infinity。
  • dischargingTime(數值):距完全放電(系統進入休眠)剩餘的秒數。無法估算、無電池或正在充電時為 Infinity。
  • level(數值):電量等級,範圍 0~1,對應剩餘百分比。1.0 代表已充滿、無電池或數值不可用。

四個對應事件

每個屬性都綁定一個事件,用來通知狀態變化。例如插入電源會讓 charging 從 false 變成 true,同時觸發 chargingchange。

  • chargingchange → 對應 onchargingchange
  • chargingtimechange → 對應 onchargingtimechange
  • dischargingtimechange → 對應 ondischargingtimechange
  • levelchange → 對應 onlevelchange

完整示例

下面的頁面把四個屬性顯示出來,並在事件觸發時重新整理畫面。使用新版 API 時,記得在 Promise 的 then 裡註冊事件。

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8" />
<title>Battery Status API - Example</title>
<script>
function bindBatteryEvents(battery) {
  function displayBatteryStats() {
    document.getElementById('charging').textContent =
      battery.charging ? '充電中' : '未使用電源';
    document.getElementById('chargingtime').textContent = battery.chargingTime;
    document.getElementById('dischargingtime').textContent = battery.dischargingTime;
    document.getElementById('level').textContent = battery.level * 100;
  }

  displayBatteryStats();
  battery.addEventListener('chargingchange', displayBatteryStats, false);
  battery.addEventListener('chargingtimechange', displayBatteryStats, false);
  battery.addEventListener('dischargingtimechange', displayBatteryStats, false);
  battery.addEventListener('levelchange', displayBatteryStats, false);
}

window.addEventListener('load', function () {
  if (navigator.getBattery) {
    navigator.getBattery().then(function (battery) {
      if (battery) bindBatteryEvents(battery);
    });
  } else if (navigator.battery || navigator.mozBattery) {
    bindBatteryEvents(navigator.battery || navigator.mozBattery);
  } else {
    document.getElementById('stats').textContent =
      '很抱歉,你的瀏覽器不支援 Battery Status API';
  }
}, false);
</script>
</head>
<body>
<div id="stats">
  目前狀態:<span id="charging"></span><br />
  充滿還需 <span id="chargingtime"></span> 秒<br />
  可用電力還剩 <span id="dischargingtime"></span> 秒<br />
  電量 <span id="level"></span>%
</div>
</body>
</html>

實際上該拿它做什麼

最常見的用法是「省電模式」:電量低於某個門檻就停止自動播放、降低動畫幀率、把輪詢間隔拉長;充電時則恢復完整效果。因為這些數值隨時在變,與其定時輪詢,不如直接掛 levelchange 事件來得省事又省電。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved