Acelerometro

org.apache.cordova.device-motion

Este plugin da acceso al acelerómetro del dispositivo. El acelorómetro es un sensor de movimiento que detecta cualquier cambio relativo a la orientación del dispositivo, en las tres dimensiones del eje (x, y & z).

Instalación

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

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Tizen
  • Windows Phone 7 y 8
  • Windows 8
  • navigator.accelerometer.getCurrentAcceleration
  • navigator.accelerometer.watchAcceleration
  • navigator.accelerometer.clearWatch
  • Acceleration

Métodos

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

navigator.accelerometer.getCurrentAcceleration

Obtiene la aceleración actual en los ejes x, y y z. Dichos valores son devueltos a la función  accelerometerSuccess.

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

navigator.accelerometer.watchAcceleration

Recibe la actual Acceleration del dispositivo en un intervalo regular, ejecutando la función accelerometerSuccess cada vez. Se especifica los intervalos en milisegundos a través del objeto acceleratorOptions y su parámetro frequency.

  • accelerometerOptions: Un objeto que contiene la siguiente opción.
  • frequency: Con qué frecuencia se recibe la Acceleration en milisegundos.(Number) (Por defecto: 10000)

navigator.accelerometer.clearWatch

Detiene el visionado de la Acceleration referenciada por el parámetro watchID.

navigator.accelerometer.clearWatch(watchID);
  • watchID: El ID devuelto por navigator.accelerometer.watchAcceleration.

Objetos

Acceleration

Contiene los datos capturados de  en un punto específico de tiempo. Los valores de la aceleración incluye los efectos de la gravedad (9,81 m/s2), lo que significa que si el dispositivo está sobre una superficie plana y defrente los valores de x, y y z serían 0, 0 y 9,81.

Propiedades

  • x: Aceleración en el eje X. (en m/s2) (Number)
  • y: Aceleración en el eje Y. (in m/s2) (Number)
  • z: Aceleración en el eje Z. (in m/s2) (Number)
  • timestamp: Tiempo del instante en milisegundos. (DOMTimeStamp)