Spec-Zone.ru › Cordova 9

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);
}

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

  • iOS
  • Android
  • Windows
  • Браузер (Chrome, Firefox, Opera)

Особенности: Android

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

Событие batterylow

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

Пример

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

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

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

  • iOS
  • Android
  • Windows
  • Браузер (Chrome, Firefox, Opera)

Событие batterycritical

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

Пример

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

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

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

  • iOS
  • Android
  • Windows
  • Браузер (Chrome, Firefox, Opera)

© 2012, 2013, 2015 The Apache Software Foundation
Licensed under the Apache License 2.0.
https://cordova.apache.org/docs/en/9.x/reference/cordova-plugin-battery-status/index.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API