org.apache.cordova.device-orientation

このプラグインは、デバイスのコンパスへのアクセスを提供します。 コンパスは方向またはというデバイスは、通常から指摘装置の上部の見出しを検出するセンサーです。 359.99、0 は北に 0 からの角度で見出しを測定します。

インストール

cordova plugin add org.apache.cordova.device-orientation

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

  • アマゾン火 OS
  • アンドロイド
  • ブラックベリー 10
  • ブラウザー
  • Firefox の OS
  • iOS
  • Tizen
  • Windows Phone 7 および 8 (可能な場合ハードウェアで)
  • Windows 8

メソッド

  • navigator.compass.getCurrentHeading
  • navigator.compass.watchHeading
  • navigator.compass.clearWatch

navigator.compass.getCurrentHeading

現在のコンパス方位を取得します。コンパス針路経由で返されます、 CompassHeading オブジェクトを使用して、 compassSuccess コールバック関数。

navigator.compass.getCurrentHeading compassSuccess （compassError）;

例

function onSuccess(heading) {
    alert('Heading: ' + heading.magneticHeading);
};

function onError(error) {
    alert('CompassError: ' + error.code);
};

navigator.compass.getCurrentHeading(onSuccess, onError);

navigator.compass.watchHeading

デバイスの定期的な間隔で現在の方位を取得します。見出しを取り出すたびに、 headingSuccess コールバック関数が実行されます。

返される時計 ID コンパス時計腕時計間隔を参照します。時計を持つ ID を使用することができます navigator.compass.clearWatch 、navigator.compass を見て停止します。

var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);

compassOptions次のキーを含めることができます。

  • 周波数: 多くの場合、コンパス針路 (ミリ秒単位) を取得する方法。(数)(デフォルト: 100)
  • フィルター: watchHeading 成功時のコールバックを開始する必要度の変化。この値を設定すると、頻度は無視されます。(数)

例

function onSuccess(heading) {
    var element = document.getElementById('heading');
    element.innerHTML = 'Heading: ' + heading.magneticHeading;
};

function onError(compassError) {
    alert('Compass error: ' + compassError.code);
};

var options = {
    frequency: 3000
}; // Update every 3 seconds

var watchID = navigator.compass.watchHeading(onSuccess, onError, options);

ブラウザーの癖

現在の見出しの値は、コンパスをシミュレートするためにランダムに生成されます。

iOS の癖

1 つだけ watchHeading iOS で一度に有効にすることができます。 場合は、 watchHeading 、フィルターを使用して呼び出す getCurrentHeading または watchHeading 既存のフィルターの値を使用して見出しの変更を指定します。 フィルターを使用して見出しの変更を見て時間間隔よりも効率的にファイルです。

アマゾン火 OS 癖

  • filterサポートされていません。

Android の癖

  • サポートされていませんfilter.

Firefox OS 癖

  • サポートされていませんfilter.

Tizen の癖

  • サポートされていませんfilter.

Windows Phone 7 と 8 癖

  • サポートされていませんfilter.

navigator.compass.clearWatch

時計 ID パラメーターによって参照されるコンパスを見て停止します。

navigator.compass.clearWatch(watchID);
  • watchID: によって返される IDnavigator.compass.watchHeading.

例

var watchID = navigator.compass.watchHeading(onSuccess, onError, options);

// ... later on ...

navigator.compass.clearWatch(watchID);

CompassHeading

A CompassHeading オブジェクトに返される、 compassSuccess コールバック関数。

プロパティ

  • magneticHeading: 1 つの時点で 0 359.99 から角度での見出し。(数)

  • trueHeading: 度 0 359.99 で地理的な北極を基準にして、1 つの時点での見出し。 負の値は真針路を特定できないことを示します。 (数)

  • headingAccuracy: 報告された見出しと真方位角度偏差。(数)

  • タイムスタンプ: この見出しを決定した時。(ミリ秒)

アマゾン火 OS 癖

  • trueHeadingレポートと同じ値はサポートされていませんmagneticHeading

  • headingAccuracy常に 0 の間の違いはありませんので、 magneticHeading とtrueHeading

Android の癖

  • trueHeadingプロパティはサポートされていませんと同じ値を報告magneticHeading.

  • headingAccuracyプロパティは常に 0 の間の違いはありませんので、 magneticHeading とtrueHeading.

Firefox OS 癖

  • trueHeadingプロパティはサポートされていませんと同じ値を報告magneticHeading.

  • headingAccuracyプロパティは常に 0 の間の違いはありませんので、 magneticHeading とtrueHeading.

iOS の癖

  • trueHeading経由で有効になっている位置情報サービスのプロパティが返されますのみnavigator.geolocation.watchLocation().

  • IOS 4 デバイス上見出しデバイスの現在の向きの要因そして、その向きをサポートするアプリケーションのための絶対位置を参照していません。

CompassError

A CompassError オブジェクトに返される、 compassError コールバック関数でエラーが発生したとき。

プロパティ

  • コード: 次のいずれかの定義済みのエラー コード。

定数

  • CompassError.COMPASS_INTERNAL_ERR
  • CompassError.COMPASS_NOT_SUPPORTED