tree: cc7969f2c0725fed537b0fec96308ce73b12784a [path history] [tgz]
  1. index.md
  2. README.md
doc/de/README.md

cordova-plugin-device-motion

Build Status

Dieses Plugin ermöglicht den Zugriff auf das Gerät Beschleunigungsmesser. Der Beschleunigungsmesser ist ein Bewegungssensor, der die Änderung (Delta) erkennt Bewegung im Verhältnis zu der aktuellen Geräte-Orientierung, in drei Dimensionen entlang der x-, *y-*und Z -Achse.

Der Zugang ist über eine globale navigator.accelerometer-Objekt.

Obwohl das Objekt mit der globalen Gültigkeitsbereich navigator verbunden ist, steht es nicht bis nach dem Deviceready-Ereignis.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.accelerometer);
}

Installation

cordova plugin add cordova-plugin-device-motion

Unterstützte Plattformen

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Browser
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 8
  • Windows

Methoden

  • navigator.accelerometer.getCurrentAcceleration
  • navigator.accelerometer.watchAcceleration
  • navigator.accelerometer.clearWatch

Objekte

  • Beschleunigung

navigator.accelerometer.getCurrentAcceleration

Erhalten Sie die aktuelle Beschleunigung entlang der x-, y- und z-Achsen.

Diese Beschleunigungswerte werden an die accelerometerSuccess-Callback-Funktion zurückgegeben.

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

Beispiel

function onSuccess(acceleration) {
    alert('Acceleration X: ' + acceleration.x + '\n' +
          'Acceleration Y: ' + acceleration.y + '\n' +
          'Acceleration Z: ' + acceleration.z + '\n' +
          'Timestamp: '      + acceleration.timestamp + '\n');
};

function onError() {
    alert('onError!');
};

navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);

Browser-Eigenheiten

Werte für X, Y, Z-Bewegung sind alle zufällig generierten in Ordnung, den Beschleunigungsmesser zu simulieren.

iOS Macken

  • iOS erkennt nicht das Konzept die aktuelle Beschleunigung zu einem bestimmten Zeitpunkt zu bekommen.

  • Müssen Sie die Beschleunigung zu sehen und erfassen die Daten zu bestimmten Zeitintervallen.

  • So die getCurrentAcceleration -Funktion führt zu den letzten Wert berichtet von einer watchAccelerometer rufen.

navigator.accelerometer.watchAcceleration

Ruft das Gerät aktuelle Accelerometer in regelmäßigen Abständen, die accelerometerSuccess-Callback-Funktion jedes Mal ausgeführt. Gibt das Intervall in Millisekunden über das AcceleratorOptions-Objekt-frequency-Parameter.

Die zurückgegebenen Watch-ID verweist der Beschleunigungsmesser Uhr Intervall und kann mit navigator.accelerometer.clearWatch um zu stoppen, beobachten den Beschleunigungsmesser verwendet werden.

var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
                                                       accelerometerError,
                                                       accelerometerOptions);
  • accelerometerOptions: Ein Objekt mit den folgenden optionalen Elementen:
    • Zeitraum: gewünschten Zeitraum der Aufrufe von AccelerometerSuccess mit Beschleunigungsdaten in Millisekunden. (Anzahl) (Default: 10000)

Beispiel

function onSuccess(acceleration) {
    alert('Acceleration X: ' + acceleration.x + '\n' +
          'Acceleration Y: ' + acceleration.y + '\n' +
          'Acceleration Z: ' + acceleration.z + '\n' +
          'Timestamp: '      + acceleration.timestamp + '\n');
};

function onError() {
    alert('onError!');
};

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

var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);

iOS Macken

Die API ruft die Erfolg-Callback-Funktion im Intervall angefordert, aber schränkt den Bereich der Anforderungen an das Gerät zwischen 40ms und 1000ms. Beispielsweise wenn Sie ein Intervall von 3 Sekunden, (3000ms), beantragen die API fordert Daten vom Gerät jede 1 Sekunde, aber nur den Erfolg-Rückruf führt alle 3 Sekunden.

navigator.accelerometer.clearWatch

Hör auf, beobachten die Beschleunigung durch den watchID-Parameter verwiesen.

navigator.accelerometer.clearWatch(watchID);
  • WatchID: die ID von zurückgegebennavigator.accelerometer.watchAcceleration.

Beispiel

var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);

// ... later on ...

navigator.accelerometer.clearWatch(watchID);

Beschleunigung

Zu einem bestimmten Zeitpunkt im Zeit erfasste Accelerometer-Daten enthält. Beschleunigungswerte sind die Auswirkungen der Schwerkraft (9.81 m/s ^ 2), so dass wenn ein Gerät flach und nach oben, X, y liegt, und Z-Werte zurückgegeben werden, , und 9.81 sollte.

Eigenschaften

  • X: Betrag der Beschleunigung auf der x-Achse. (in m/s ^ 2) (Anzahl)
  • y: Betrag der Beschleunigung auf der y-Achse. (in m/s ^ 2) (Anzahl)
  • Z: Betrag der Beschleunigung auf die z-Achse. (in m/s ^ 2) (Anzahl)
  • Timestamp: Zeitstempel der Erstellung in Millisekunden. (DOMTimeStamp)