cordova-plugin-battery-status

Android Testsuite Chrome Testsuite iOS Testsuite Lint Test

此插件提供了旧版 电池状态事件 API 的实现。它向 window 对象添加了以下三个事件

  • batterystatus
  • batterycritical
  • batterylow

应用程序可以在 deviceready 事件触发后使用 window.addEventListener 为上述任何事件附加事件监听器。

安装

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
  • 浏览器 (Chrome、Firefox、Opera)

怪癖:Android

警告:Android 实现很贪婪,长时间使用会耗尽设备的电池电量。

batterylow 事件

当电池电量百分比达到低电量阈值时触发。此阈值是特定于设备的。返回一个包含电池状态的 对象

示例

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

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

支持的平台

  • iOS
  • Android
  • 浏览器 (Chrome、Firefox、Opera)

batterycritical 事件

当电池电量百分比达到临界电量阈值时触发。此阈值是特定于设备的。返回一个包含电池状态的 对象

示例

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

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

支持的平台

  • iOS
  • Android
  • 浏览器 (Chrome、Firefox、Opera)