batterycritical

このイベントはバッテリー残量が危険な閾値に達したことを Cordova アプリケーションが検知したときに呼び出されます。

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

詳細

このイベントはバッテリー残量が危険なパーセンテージの閾値に達したことを Cordova アプリケーションが検知したときに呼び出されます。この値はデバイス固有です。

batterycritical ハンドラーは以下の2つのプロパティーを含むオブジェクトを伴って呼び出されます:

  • level: バッテリーのパーセンテージ (0-100) (Number)
  • isPlugged: デバイスが充電器に接続されているかどうかを表します (Boolean)

通常は、 Cordova の 'deviceready' イベントを受け取った後、 window.addEventListener を通じてイベントリスナーをセットします。

サポートされているプラットフォーム

  • iOS
  • Android
  • BlackBerry WebWorks (OS 5.0 以上)

使用例

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

function onBatteryCritical(info) {
    // バッテリー関する操作を記述
    alert("バッテリー残量が危険です " + info.level + "%\nすぐに充電してください。");
}

詳細な使用例

<!DOCTYPE html>
<html>
  <head>
    <title>Cordova Device Ready 使用例</title>

    <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Cordova のロード完了とともに onDeviceReady を呼び出します。
    //
    // この時点では、ドキュメントの読み込みは完了していますが、 cordova-1.8.1.js はまだ完了していません。
    // Cordova のロード完了とともに
    // `deviceready` イベントが呼び出されます。
    //
    function onLoad() {
        document.addEventListener("deviceready", onDeviceReady, false);
    }

    // Cordova 準備完了
    //
    function onDeviceReady() {
        window.addEventListener("batterycritical", onBatteryCritical, false);
    }

    // バッテリー関する操作を記述
    //
    function onBatteryCritical(info) {
        alert("バッテリー残量が危険です " + info.level + "%\nすぐに充電してください。");
    }

    </script>
  </head>
  <body onload="onLoad()">
  </body>
</html>