compass.getCurrentHeading

Erhalten Sie aktuelle Kompassrichtung.

navigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions);

Beschreibung

Der Kompass ist ein Sensor, der erkennt die Richtung oder Position, dass das Gerät in der Regel von der Oberseite des Geräts gezeigt wird. Er misst die Überschrift im Grad von 0 bis 359.99, wobei 0 Norden ist.

Die Kompassrichtung Informationen über zurückgegeben ein CompassHeading -Objekt unter Verwendung der [compassSuccess](parameters/compassSuccess.html) Callback-Funktion.

Unterstützte Plattformen

  • Android
  • BlackBerry 10
  • iOS
  • Tizen
  • Windows Phone 7 und 8 (falls verfügbar in Hardware)
  • Windows 8

Kleines Beispiel

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

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

navigator.compass.getCurrentHeading(onSuccess, onError);

Vollständiges Beispiel

<!DOCTYPE html>
<html>
  <head>
    <title>Compass Example</title>

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

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.compass.getCurrentHeading(onSuccess, onError);
    }

    // onSuccess: Get the current heading
    //
    function onSuccess(heading) {
        alert('Heading: ' + heading.magneticHeading);
    }

    // onError: Failed to get the heading
    //
    function onError(compassError) {
        alert('Compass Error: ' + compassError.code);
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>getCurrentHeading</p>
  </body>
</html>