Este plugin proporciona acceso al compás del dispositivo. La brújula es un sensor que detecta la dirección o rumbo que el dispositivo está apuntado, normalmente desde la parte superior del dispositivo. Mide el rumbo en grados de 0 a 359.99, donde 0 es el norte.
El acceso es por un global navigator.compass
objeto.
Aunque el objeto está unido al ámbito global navigator
, no estará disponible hasta después de la deviceready
evento.
document.addEventListener("deviceready", onDeviceReady, false); function onDeviceReady() { console.log(navigator.compass); }
cordova plugin add cordova-plugin-device-orientation
Conseguir el actual rumbo de la brújula. El rumbo de la brújula es devuelto vía un CompassHeading
objeto usando la compassSuccess
función de callback.
navigator.compass.getCurrentHeading(compassSuccess, compassError);
function onSuccess(heading) { alert('Heading: ' + heading.magneticHeading); }; function onError(error) { alert('CompassError: ' + error.code); }; navigator.compass.getCurrentHeading(onSuccess, onError);
Obtiene el título actual del dispositivo a intervalos regulares. Cada vez que se recupera el título, el headingSuccess
se ejecuta la función callback.
El identificador devuelto reloj referencias el intervalo reloj brújula. El reloj ID puede utilizarse con navigator.compass.clearWatch
para dejar de ver la navigator.compass.
var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);
compassOptions
puede contener las siguientes claves:
function onSuccess(heading) { var element = document.getElementById('heading'); element.innerHTML = 'Heading: ' + heading.magneticHeading; }; function onError(compassError) { alert('Compass error: ' + compassError.code); }; var options = { frequency: 3000 }; // Update every 3 seconds var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
Los valores de partida actual son generados al azar para simular la brújula.
Solamente un watchHeading
puede ser en efecto a la vez en iOS. Si un watchHeading
utiliza un filtro, llamando a getCurrentHeading
o watchHeading
utiliza el valor existente del filtro para especificar los cambios de rumbo. Observando los cambios de rumbo con un filtro es más eficiente que con intervalos de tiempo.
filter
No se admite.filter
.filter
.filter
.filter
.Deja de mirar la brújula al que hace referencia el parámetro ID de reloj.
navigator.compass.clearWatch(watchID);
navigator.compass.watchHeading
.var watchID = navigator.compass.watchHeading(onSuccess, onError, options); // ... later on ... navigator.compass.clearWatch(watchID);
A CompassHeading
objeto es devuelto a la compassSuccess
función de callback.
magneticHeading: el rumbo en grados de 0-359.99 en un solo momento. (Número)
trueHeading: el título en relación con el polo norte geográfico en grados 0-359.99 en un solo momento. Un valor negativo indica que no se puede determinar el rumbo verdadero. (Número)
headingAccuracy: la desviación en grados entre el rumbo divulgado y el rumbo verdadero. (Número)
timestamp: el momento en el cual se determinó esta partida. (milisegundos)
trueHeading
No es compatible, pero el mismo valor que los informesmagneticHeading
headingAccuracy
es siempre 0 porque no hay ninguna diferencia entre el magneticHeading
ytrueHeading
El trueHeading
propiedad no es compatible, pero el mismo valor que los informesmagneticHeading
.
El headingAccuracy
propiedad es siempre 0 porque no hay ninguna diferencia entre el magneticHeading
ytrueHeading
.
El trueHeading
propiedad no es compatible, pero el mismo valor que los informesmagneticHeading
.
El headingAccuracy
propiedad es siempre 0 porque no hay ninguna diferencia entre el magneticHeading
ytrueHeading
.
trueHeading
propiedad es devuelto sólo para servicios de localización habilitados mediantenavigator.geolocation.watchLocation()
.A CompassError
objeto es devuelto a la compassError
función de devolución de llamada cuando se produce un error.
CompassError.COMPASS_INTERNAL_ERR
CompassError.COMPASS_NOT_SUPPORTED