From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- files/zh-tw/web/api/battery_status_api/index.html | 38 +++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 files/zh-tw/web/api/battery_status_api/index.html (limited to 'files/zh-tw/web/api/battery_status_api') diff --git a/files/zh-tw/web/api/battery_status_api/index.html b/files/zh-tw/web/api/battery_status_api/index.html new file mode 100644 index 0000000000..cbf98d417d --- /dev/null +++ b/files/zh-tw/web/api/battery_status_api/index.html @@ -0,0 +1,38 @@ +--- +title: Battery Status API +slug: Web/API/Battery_Status_API +translation_of: Web/API/Battery_Status_API +--- +

Battery Status API 也就是所謂的 Battery API，將提供系統電池充電容量的資訊，並在電池容量變化時送出事件，以通知使用者。此 API 可調整 Apps 的資源耗用量，在電力偏低時縮減耗電量；或可在電力耗盡之前儲存檔案，避免資料遺失。

+

Battery Status API 是以 window.navigator.battery 屬性 (為 BatteryManager 物件) 而擴充了 window.navigator，並新增數項可讓使用者接收的新事件，以隨時監控電池狀態。

+

範例

+

在此範例中，我們將分別監聽 chargingchange 與 levelchange 事件，而看到充電狀態 (不論是否插電進行充電) 與電池容量的變化。

+
var battery = navigator.battery || navigator.mozBattery || navigator.webkitBattery;
+
+function updateBatteryStatus() {
+  console.log("Battery status: " + battery.level * 100 + " %");
+
+  if (battery.charging) {
+    console.log("Battery is charging");
+  }
+}
+
+battery.addEventListener("chargingchange", updateBatteryStatus);
+battery.addEventListener("levelchange", updateBatteryStatus);
+updateBatteryStatus();
+
+

另可參閱規格所提供之範例。

+

規格

+

{{page("/en-US/docs/Web/API/BatteryManager","Specifications")}}

+

瀏覽器相容性

+

{{page("/en-US/docs/Web/API/BatteryManager","Browser_compatibility")}}

+

另請參閱

+ -- cgit v1.2.3-54-g00ecf