| commit | b738071565c4ec3d9b3c037eff549b97fd458313 | [log] [tgz] |
|---|---|---|
| author | Vladimir Kotikov <kotikov.vladimir@gmail.com> | Wed Aug 31 16:09:11 2016 +0300 |
| committer | sgrebnov <sergei.grebnov@gmail.com> | Thu Sep 08 11:35:41 2016 +0300 |
| tree | d1e608c2e83811e0ea035c5478ebd8d225a80ca5 | |
| parent | e11f8673e6c46ac824e9691b1efaf190dad5b31d [diff] |
CB-11795 Add 'protective' entry to cordovaDependencies This entry is required to protect end-users from fetching edge versions of the plugin by incompatible version of cordova. This also assumes that we will not introduce any regressions in compatibility w/ cordova in minor and patch releases. On every major release we will need to add similar entry with _next_ major version. This closes #39
| Android | iOS | Windows 8.1 Store | Windows 8.1 Phone | Windows 10 Store | Travis CI |
|---|---|---|---|---|---|
 |
This plugin provides an implementation of an old version of the Battery Status Events API. It adds the following three events to the window object:
Applications may use window.addEventListener to attach an event listener for any of the above events after the deviceready event fires.
cordova plugin add cordova-plugin-battery-status
All events in this plugin return an object with the following properties:
Fires when the battery charge percentage changes by at least 1 percent, or when the device is plugged in or unplugged. Returns an object containing battery status.
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(status) {
console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}
Warning: the Android and Fire OS implementations are greedy and prolonged use will drain the device's battery.
The level property is not supported on Windows Phone 7 because the OS does not provide native APIs to determine battery level. The isPlugged parameter is supported.
The isPlugged parameter is not supported on Windows Phone 8.1. The level parameter is supported.
Fires when the battery charge percentage reaches the low charge threshold. This threshold value is device-specific. Returns an object containing battery status.
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
alert("Battery Level Low " + status.level + "%");
}
The batterylow event fires on Windows Phone 8.1 irrespective of whether the device is plugged in or not. This happens because the OS does not provide an API to detect whether the device is plugged in.
Fires when the battery charge percentage reaches the critical charge threshold. This threshold value is device-specific. Returns an object containing battery status.
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}
The batterycritical event fires on Windows Phone 8.1 irrespective of whether the device is plugged in or not. This happens because the OS does not provide an API to detect whether the device is plugged in.