org.apache.cordova.device-motion

Este plugin proporciona acceso a acelerómetro del dispositivo. El acelerómetro es un sensor de movimiento que detecta el cambio (delta) en movimiento con respecto a la orientación actual del dispositivo, en tres dimensiones sobre el eje x, yy z .

Instalación

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

Plataformas soportadas

  • Amazon fuego OS
  • Android
  • BlackBerry 10
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 y 8
  • Windows 8

Métodos

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

Objetos

  • Acceleration

navigator.accelerometer.getCurrentAcceleration

Tienes la aceleración actual a lo largo de los ejes x, yy z .

Estos valores de aceleración son devueltos a la accelerometerSuccess función de callback.

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

Ejemplo

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 rarezas

  • iOS no reconoce el concepto de conseguir la aceleración actual en cualquier momento dado.

  • Debes ver la aceleración y capturar los datos en determinados intervalos de tiempo.

  • Así, el getCurrentAcceleration función rinde el último valor reportado de una watchAccelerometer llamada.

navigator.accelerometer.watchAcceleration

Recupera el dispositivo actual de Acceleration a intervalos regulares, ejecutar el accelerometerSuccess función callback cada vez. Especificar el intervalo en milisegundos mediante la acceleratorOptions del objeto frequency parámetro.

El vuelto ver referencias ID intervalo del acelerómetro reloj y puede ser utilizado con navigator.accelerometer.clearWatch para dejar de ver el acelerómetro.

var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
                                                       accelerometerError,
                                                       [accelerometerOptions]);
  • accelerometerOptions: Un objeto con las llaves opcionales siguientes:
    • frecuencia: frecuencia con la que recuperar la Acceleration en milisegundos. (Número) (Por defecto: 10000)

Ejemplo

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 rarezas

La API llama a la función de devolución de llamada de éxito en el intervalo solicitado, pero restringe la gama de solicitudes que el dispositivo entre 40ms y 1000ms. Por ejemplo, si usted solicita un intervalo de 3 segundos, (3000ms), la API pide datos desde el dispositivo cada 1 segundo, pero sólo ejecuta el callback de éxito cada 3 segundos.

navigator.accelerometer.clearWatch

Dejar de ver la Acceleration que se hace referencia por la watchID parámetro.

navigator.accelerometer.clearWatch(watchID);
  • watchID: el identificador devuelto pornavigator.accelerometer.watchAcceleration.

Ejemplo

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

// ... later on ...

navigator.accelerometer.clearWatch(watchID);

Aceleración

Contiene Accelerometer datos capturados en un punto específico en el tiempo. Valores de aceleración incluyen el efecto de la gravedad (9,81 m/s ^ 2), de modo que cuando se encuentra un dispositivo plano y hacia arriba, x, y, y z valores devueltos deben ser , , y9.81.

Propiedades

  • x: cantidad de aceleración en el eje x. (en m/s ^ 2) (Número)
  • y: cantidad de aceleración en el eje y. (en m/s ^ 2) (Número)
  • z: cantidad de aceleración en el eje z. (en m/s ^ 2) (Número)
  • timestamp: fecha y hora creación en milisegundos. (DOMTimeStamp)