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
• 瀏覽器 (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)