tree: 760c6131f49e9e39cc5f0c19652cc539e9e8755e [path history] [tgz]
  1. index.md
  2. README.md
doc/zh/README.md

cordova-plugin-battery-status

Build Status

這個外掛程式提供的舊版本的電池狀態事件 API實現的.

它將添加以下三 window 事件:

  • batterystatus
  • batterycritical
  • batterylow

安裝

cordova plugin add cordova-plugin-battery-status

batterystatus

當電池計量的百分比改變了至少 1%,或如果在插入或拔出該設備會觸發此事件。

電池狀態處理常式傳遞一個物件,包含兩個屬性:

  • 級別: 電池充電 (0-100) 的百分比。(人數)

  • isPlugged: 一個布林值,該值指示設備是否插*(布林值)*

應用程式通常應使用 window.addEventListener 將附加一個事件攔截器後的 deviceready 事件觸發。

支援的平臺

  • 亞馬遜火 OS
  • iOS
  • Android 系統
  • 黑莓 10
  • Windows Phone 7 和 8
  • Windows (僅限於 Windows Phone 8.1)
  • Tizen
  • 火狐瀏覽器作業系統

安卓和亞馬遜火 OS 怪癖

  • 警告: Android + 火 OS 實現都是貪婪和長時間的使用會流失使用者的電池。

Windows Phone 7 和 8 怪癖

Windows Phone 7 並不提供本機 Api 來確定電池計量水準,所以 level 是不可用的屬性。isPlugged參數**支援的。

Windows 的怪癖

Windows Phone 8.1 不支援isPlugged參數。 水準參數**支援。

示例

window.addEventListener("batterystatus", onBatteryStatus, false);

function onBatteryStatus(info) {
    // Handle the online event
    console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
}

batterycritical

當電池計量的百分比已達到關鍵電池閾值時,將觸發該事件。值是特定于設備。

batterycritical處理常式傳遞一個物件,包含兩個屬性:

  • 級別: 電池充電 (0-100) 的百分比。(人數)

  • isPlugged: 一個布林值,該值指示設備是否插*(布林值)*

應用程式通常應使用 window.addEventListener 將一個事件攔截器附加一次 deviceready 事件火災。

支援的平臺

  • 亞馬遜火 OS
  • iOS
  • Android 系統
  • 黑莓 10
  • Tizen
  • 火狐瀏覽器作業系統
  • Windows (僅限於 Windows Phone 8.1)

Windows 的怪癖

Windows Phone 8.1 會觸發batterycritical事件任何堵塞狀態,因為它不支援。

示例

window.addEventListener("batterycritical", onBatteryCritical, false);

function onBatteryCritical(info) {
    // Handle the battery critical event
    alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
}

batterylow

當電池計量的百分比已達到電池計量低門檻,設備特定值時,將觸發該事件。

batterylow處理常式傳遞一個物件,包含兩個屬性:

  • 級別: 電池充電 (0-100) 的百分比。(人數)

  • isPlugged: 一個布林值,該值指示設備是否插*(布林值)*

應用程式通常應使用 window.addEventListener 將一個事件攔截器附加一次 deviceready 事件火災。

支援的平臺

  • 亞馬遜火 OS
  • iOS
  • Android 系統
  • 黑莓 10
  • Tizen
  • 火狐瀏覽器作業系統
  • Windows (僅限於 Windows Phone 8.1)

Windows 的怪癖

Windows Phone 8.1 會觸發batterylow事件任何堵塞狀態,因為它不支援。

示例

window.addEventListener("batterylow", onBatteryLow, false);

function onBatteryLow(info) {
    // Handle the battery low event
    alert("Battery Level Low " + info.level + "%");
}