| <!-- |
| # license: Licensed to the Apache Software Foundation (ASF) under one |
| # or more contributor license agreements. See the NOTICE file |
| # distributed with this work for additional information |
| # regarding copyright ownership. The ASF licenses this file |
| # to you under the Apache License, Version 2.0 (the |
| # "License"); you may not use this file except in compliance |
| # with the License. You may obtain a copy of the License at |
| # |
| # http://www.apache.org/licenses/LICENSE-2.0 |
| # |
| # Unless required by applicable law or agreed to in writing, |
| # software distributed under the License is distributed on an |
| # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| # KIND, either express or implied. See the License for the |
| # specific language governing permissions and limitations |
| # under the License. |
| --> |
| |
| # 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 <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 + "%"); |
| } |