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

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 :
    • frequency: Fréquence de récupération de l'Acceleration en millisecondes. (Number) (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 callback 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 exécute seulement le callback de succès toutes les 3 secondes.

navigator.accelerometer.clearWatch

Arrêter la surveillance du Acceleration référencée par le paramètre watchID.

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 les données Accelerometer capturées à un moment donné 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)