cordova-plugin-battery-status

Этот плагин предоставляет реализацию старой версии API событий состояния батареи. Он добавляет следующие три события к объекту window:

• batterystatus
• batterycritical
• batterylow

Приложения могут использовать window.addEventListener для добавления обработчика событий для любого из вышеперечисленных событий после того, как произойдёт событие deviceready.

Установка

cordova plugin add cordova-plugin-battery-status

Объект статуса

Все события в этом плагине возвращают объект со следующими свойствами:

• level: Процент заряда батареи (0-100). (Число)
• isPlugged: Логическое значение, указывающее, подключено ли устройство к зарядному устройству. (Булево значение)

Событие batterystatus

Срабатывает при изменении процента заряда батареи как минимум на 1 процент или при подключении или отключении устройства от источника питания. Возвращает объект содержащий состояние батареи.

Пример

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

function onBatteryStatus(status) {
    console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}

Поддерживаемые платформы

• Amazon Fire OS
• iOS
• Android
• BlackBerry 10
• Windows Phone 7 и 8
• Windows (только Windows Phone 8.1)
• Firefox OS
• Браузер (Chrome, Firefox, Opera)

Особенности: Android и Amazon Fire OS

Предупреждение: реализации для Android и Fire OS жадные, и продолжительное использование будет разряжать батарею устройства.

Особенности: Windows Phone 7 и Windows Phone 8

Свойство level не поддерживается в Windows Phone 7, так как операционная система не предоставляет собственных API для определения уровня заряда батареи. Параметр isPlugged поддерживается.

Особенности: Windows Phone 8.1

Параметр isPlugged не поддерживается в Windows Phone 8.1. Параметр level поддерживается.

Событие batterylow

Срабатывает, когда процент заряда батареи достигает порога низкого заряда. Это пороговое значение зависит от устройства. Возвращает объект, содержащий состояние батареи.

Пример

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

function onBatteryLow(status) {
    alert("Battery Level Low " + status.level + "%");
}

Поддерживаемые платформы

• Amazon Fire OS
• iOS
• Android
• BlackBerry 10
• Firefox OS
• Windows (только Windows Phone 8.1)
• Браузер (Chrome, Firefox, Opera)

Особенности: Windows Phone 8.1

Событие batterylow срабатывает в Windows Phone 8.1 независимо от того, подключено ли устройство к зарядному устройству или нет. Это происходит потому, что операционная система не предоставляет API для определения подключения устройства к зарядному устройству.

Событие batterycritical

Срабатывает, когда процент заряда батареи достигает критического порога заряда. Это пороговое значение зависит от устройства. Возвращает объект содержащий состояние батареи.

Пример

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

function onBatteryCritical(status) {
    alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}

Поддерживаемые платформы

• Amazon Fire OS
• iOS
• Android
• BlackBerry 10
• Firefox OS
• Windows (только Windows Phone 8.1)
• Браузер (Chrome, Firefox, Opera)

Особенности: Windows Phone 8.1

Событие batterycritical срабатывает в Windows Phone 8.1 независимо от того, подключено ли устройство к зарядному устройству или нет. Это происходит потому, что операционная система не предоставляет API для определения подключения устройства к зарядному устройству.