このトピックでは、HTML5 アプリおよびミニアプリでバッテリー残量などのデバイスのバッテリー情報を取得するための WVBattery JavaScript API について説明します。
WVBattery.getBatteryInfo
説明
この API は、Windvane for Android 1.0.3.4 以降でのみ利用可能です。
デバイスのバッテリー情報を取得します。
入力パラメーター
なし。
コールバックパラメーター
成功時のコールバックは、次のパラメーターを返します:
[
string] level:現在のバッテリー残量。[
string] isCharging:デバイスの充電ステータス。[
string] chargingType:充電タイプ。有効な値は、AC 充電の場合はac、USB 充電の場合はusb、ワイヤレス充電の場合はwirelessです。
失敗時のコールバックは、次のパラメーターを返します:
[
string] msg:エラーメッセージ。
window.WindVane.call('WVBattery', 'getBatteryInfo', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});WVBattery.getBatteryInfoSync
説明
この API は、Windvane for Android 1.0.3.4 以降でのみ利用可能です。
デバイスのバッテリー情報を同期的に取得します。
入力パラメーター
なし。
コールバックパラメーター
成功時のコールバックは、次のパラメーターを返します:
[
string] level:現在のバッテリー残量。[
string] isCharging:デバイスの充電ステータス。[
string] chargingType:充電タイプ。有効な値は、AC 充電の場合はac、USB 充電の場合はusb、ワイヤレス充電の場合はwirelessです。
失敗時のコールバックは、次のパラメーターを返します:
[
string] msg:エラーメッセージ。
window.WindVane.call('WVBattery', 'getBatteryInfoSync', {}, function(e) {
alert('success: ' + JSON.stringify(e));
}, function(e) {
alert('failure: ' + JSON.stringify(e));
});