Plugin Brújula

Gracias al uso del plugin Compass podemos dotar nuestras aplicaciones nativas de la utilidad de la brújula de la que dispone nuestro dispositivo móvil. Tan solo hay que tener algunas consideraciones destacables para dispositivos iOS, ya que estos tienen una tasa de refresco algo diferente. La orientación que lanzas los dispositovos iOS varía solo cuando de verdad ha cambiado el valor de la orientación; así pues si el dispositivo está bastante quieto no va a devolver nuevos datos.

Instalación

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

Métodos

• compass.getCurrentHeading
• compass.watchHeading
• compass.clearWatch

 Objetos

• compassError
• compassHeading

Gracias al método watchHeading podemos monitorizar la orientación con una frecuencia que le hayamos configurado. Por defecto la frecuencia es de 100 milisegundos pero podemos adaptarla para al menos 1s. :

var options = { frequency: 1000 };
watchID = navigator.compass.watchHeading(onSuccess, onError, options);

Si la función watchHeading tiene éxito el ID va a ir guardando una orientación cada intervalo de tiempo (en este caso 1s).

De nuevo, hay que tener en consideración el manejador de eventos para cuando el dispositivo ha cargado todas las librerías de las APIs.

document.addEventListener("deviceready", onDeviceReady, false);