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 и Windows 10)
• 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 и Windows 10)
• Браузер (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 и Windows 10)
• Браузер (Chrome, Firefox, Opera)

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

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