cordova-plugin-battery-status

このプラグインは、旧バージョンのバッテリーステータスイベントAPIの実装を提供します。 window オブジェクトに以下の3つのイベントを追加します。

• 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)