# cordova-plugin-battery-status [](https://travis-ci.org/apache/cordova-plugin-battery-status) Dieses Plugin stellt eine Implementierung einer alten Version der [Batterie-Status-API](http://www.w3.org/TR/2011/WD-battery-status-20110915/) 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 wird 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 + "%"); }