org.apache.cordova.device-motion

Ce plugin permet d‘accéder à l’accéléromètre de l‘appareil. L’accéléromètre est un capteur de mouvement qui détecte la modification (delta) en mouvement par rapport à l‘orientation actuelle de l’appareil, en trois dimensions le long de l'axe x, yet z .

Installation

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

Plates-formes prises en charge

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Navigateur
  • Firefox OS
  • iOS
  • Paciarelli
  • Windows Phone 7 et 8
  • Windows 8

Méthodes

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

Objets

  • Acceleration

navigator.accelerometer.getCurrentAcceleration

Renvoie l'accélération en cours sur les axes x, yet z .

Ces valeurs d'accélération sont retournées à la fonction callback accelerometerSuccess.

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

Exemple

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);

Bizarreries navigateur

Les valeurs x, Y, motion de Z sont tous ordre généré de manière aléatoire dans pour simuler l'accéléromètre.

iOS Quirks

  • iOS ne permet pas d‘obtenir l’accélération en cours à un instant donné.

  • Vous devez observer l'accélération et capturer ses données à un intervalle de temps donné.

  • De ce fait, la fonction getCurrentAcceleration renvoie la dernière valeur retournée par un appel à watchAccelerometer.

navigator.accelerometer.watchAcceleration

Récupère le dispositif actuel de Acceleration à intervalle régulier, l‘exécution de la accelerometerSuccess fonction de rappel chaque fois. Spécifiez l’intervalle, en millisecondes, via le acceleratorOptions de l'objet frequency paramètre.

Le retourné regarder ID références intervalle de surveillance de l‘accéléromètre et peut être utilisé avec navigator.accelerometer.clearWatch d’arrêter de regarder l'accéléromètre.

var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
                                                       accelerometerError,
                                                       accelerometerOptions);
  • accelerometerOptions: Un objet avec les clés facultatives suivantes :
    • période: période demandée d‘appels à accelerometerSuccess avec les données d’accélération en millisecondes. (Nombre) (Par défaut : 10000)

Exemple

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 Quirks

L‘API appelle la fonction de rappel de succès à l’intervalle demandé, mais restreint l‘éventail des demandes à l’appareil entre 40ms et 1000ms. Par exemple, si vous demandez un intervalle de 3 secondes, (3000ms), l‘API demande des données de l’appareil toutes les 1 seconde, mais seulement exécute le rappel réussi toutes les 3 secondes.

navigator.accelerometer.clearWatch

Arrêter de regarder le Acceleration référencé par le watchID paramètre.

navigator.accelerometer.clearWatch(watchID);
  • watchID: l'ID retourné parnavigator.accelerometer.watchAcceleration.

Exemple

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

// ... later on ...

navigator.accelerometer.clearWatch(watchID);

Accélération

Contient Accelerometer données capturées à un point précis dans le temps. Valeurs d‘accélération comprennent l’effet de la pesanteur (9,81 m/s ^ 2), de sorte que lorsqu'un périphérique se trouve plat et face vers le haut, x, y, et z valeurs retournées doivent être , , et9.81.

Propriétés

  • x: Valeur de l‘accélération sur l’axe des x. (en m/s^2) (Number)
  • y: Valeur de l‘accélération sur l’axe des y. (en m/s^2) (Number)
  • y: Valeur de l‘accélération sur l’axe des z. (en m/s^2) (Number)
  • timestamp: Date de création en millisecondes. (DOMTimeStamp)