cordova-plugin-battery-status

Build Status

Dieses Plugin stellt eine Implementierung einer alten Version der Batterie-Status-API dar..

Es fügt die folgenden drei window Events hinzu:

  • batterystatus
  • batterycritical
  • batterylow

Installation

cordova plugin add cordova-plugin-battery-status

batterystatus

Dieses Ereignis wird ausgelöst, wenn sich der Prozentsatz der Akkuladung um mindestens 1 Prozent ändert, oder wenn das Gerät aufgeladen oder vom Netz getrennt wird.

Dem Batterie-Status-Event-Handler wird ein Objekt übergeben, das zwei Eigenschaften enthält:

  • Ebene: der Prozentsatz der Batterieladung (0-100). (Anzahl)

  • IsPlugged: ein boolescher Wert, der angibt, ob das Gerät eingesteckt ist (boolesch)

Anwendungen sollten in der Regel window.addEventListener verwenden, um einen Event-Listener hinzuzufügen, nachdem das deviceready -Event ausgelöst wurde.

Unterstützte Plattformen

  • Amazon Fire OS
  • iOS
  • Android
  • BlackBerry 10
  • Windows Phone 7 und 8
  • Windows (nur Windows Phone 8.1)
  • Tizen
  • Firefox OS

Android und Amazon Fire OS Macken

  • Warnung: die Android + Fire OS Implementierungen sind gierig und längerem Gebrauch lässt den Benutzer Batterie.

Windows Phone 7 und 8 Eigenarten

Windows Phone 7 bietet keine systemeigenen APIs um das Batterie-Niveau zu bestimmen, so dass die level -Eigenschaft ist nicht verfügbar. Der isPlugged -Parameter wird unterstützt.

Windows-Eigenheiten

Windows Phone 8.1 unterstützt keine IsPlugged Parameter. Der Parameter <em>wird</em> unterstützt.

Beispiel

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

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

batterycritical

Das Ereignis wird ausgelöst, wenn der Prozentsatz der Batterieladung den kritischen Akku-Schwellenwert erreicht hat. Der Wert ist gerätespezifisch.

Der batterycritical Handler übergibt ein Objekt mit zwei Eigenschaften:

  • Ebene: der Prozentsatz der Batterieladung (0-100). (Anzahl)

  • IsPlugged: ein boolescher Wert, der angibt, ob das Gerät eingesteckt ist (boolesch)

Anwendungen sollten in der Regel window.addEventListener verwenden, um einen Event-Listener hinzuzufügen, nachdem das deviceready -Event ausgelöst wurde.

Unterstützte Plattformen

  • Amazon Fire OS
  • iOS
  • Android
  • BlackBerry 10
  • Tizen
  • Firefox OS
  • Windows (nur Windows Phone 8.1)

Windows-Eigenheiten

Windows Phone 8.1 wird batterycritical Ereignis unabhängig angeschlossen Zustand ausgelöst, da es nicht unterstützt wird.

Beispiel

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

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

batterylow

Das Ereignis wird ausgelöst, wenn der Prozentsatz der Batterieladung den kritischen Akku-Schwellenwert erreicht hat. Der Wert ist gerätespezifisch.

Der batterylow Handler übergibt ein Objekt mit zwei Eigenschaften:

  • Ebene: der Prozentsatz der Batterieladung (0-100). (Anzahl)

  • IsPlugged: ein boolescher Wert, der angibt, ob das Gerät eingesteckt ist (boolesch)

Anwendungen sollten in der Regel window.addEventListener verwenden, um einen Event-Listener hinzuzufügen, nachdem das deviceready -Event ausgelöst wurde.

Unterstützte Plattformen

  • Amazon Fire OS
  • iOS
  • Android
  • BlackBerry 10
  • Tizen
  • Firefox OS
  • Windows (nur Windows Phone 8.1)

Windows-Eigenheiten

Windows Phone 8.1 wird batterylow Ereignis unabhängig angeschlossen Zustand ausgelöst, da es nicht unterstützt wird.

Beispiel

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

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