Spec-Zone.ru › Cordova 8

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/8.x/reference/cordova-plugin-battery-status/index.html

Spec-Zone.ru

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