Ce plugin permet d‘accéder à la boussole de l’appareil. La boussole est un capteur qui détecte la direction ou la position que l‘appareil est pointé, généralement par le haut de l’appareil. Il mesure la position en degrés de 0 à 359.99, où 0 est vers le Nord.
Accès se fait par un global navigator.compass
objet.
Bien que l‘objet est attaché à la portée globale navigator
, il n’est pas disponible jusqu'après la deviceready
événement.
document.addEventListener (« deviceready », onDeviceReady, false) ; function onDeviceReady() {console.log(navigator.compass);}
cordova plugin add cordova-plugin-device-orientation
Téléchargez la cours de la boussole. La boussole est renvoyé via un CompassHeading
s‘opposer à l’aide de la compassSuccess
fonction de rappel.
navigator.compass.getCurrentHeading (compassSuccess, compassError) ;
function onSuccess(heading) {alert (' intitulé: "+ heading.magneticHeading);} ; function onError(error) {alert ('CompassError: ' + error.code);} ; navigator.compass.getCurrentHeading (onSuccess, onError) ;
Obtient la position actuelle de l'appareil à intervalle régulier. Chaque fois que le titre est récupéré, la headingSuccess
fonction de rappel est exécutée.
Le code retourné montre fait référence à l‘intervalle montre boussole. La montre ID peut être utilisé avec navigator.compass.clearWatch
d’arrêter de regarder le navigator.compass.
var watchID = navigator.compass.watchHeading (compassSuccess, compassError, [compassOptions]) ;
compassOptions
peut contenir les clés suivantes :
function onSuccess(heading) {var element = document.getElementById('heading') ; element.innerHTML = "intitulé:" + heading.magneticHeading ; }; function onError(compassError) {alert (' erreur de boussole: "+ compassError.code);} ; options de var = { frequency: 3000 } ; Mise à jour chaque 3 secondes var watchID = navigator.compass.watchHeading (onSuccess, onError, options) ;
Valeurs pour la rubrique actuelle sont générés au hasard afin de simuler la boussole.
Seul watchHeading
peut être en effet à un moment donné dans l‘iOS. Si un watchHeading
utilise un filtre, appeler getCurrentHeading
ou watchHeading
utilise la valeur existante de filtre pour spécifier des changements de position. En regardant les changements de position avec un filtre est plus efficace qu’avec des intervalles de temps.
filter
n'est pas pris en charge.filter
.filter
.filter
.filter
.Arrêter de regarder la boussole référencée par le paramètre ID de montre.
navigator.compass.clearWatch(watchID) ;
navigator.compass.watchHeading
.var watchID = navigator.compass.watchHeading (onSuccess, onError, options) ; ... plus tard... navigator.compass.clearWatch(watchID) ;
A CompassHeading
objet est retourné à la compassSuccess
fonction de rappel.
magneticHeading: la position en degrés de 0-359,99 à un instant donné. (Nombre)
trueHeading: la position par rapport au pôle Nord géographique en degrés 0-359,99 à un instant donné. Une valeur négative indique que le cap vrai ne peut être déterminée. (Nombre)
headingAccuracy: la déviation en degrés entre la direction signalée et la véritable direction. (Nombre)
horodatage: l'heure à laquelle cette direction a été déterminée. (millisecondes)
trueHeading
n'est pas pris en charge, mais la même valeur que les rapportsmagneticHeading
headingAccuracy
est toujours 0 car il n'y a pas de différence entre la magneticHeading
ettrueHeading
La trueHeading
propriété n'est pas pris en charge, mais la même valeur que des rapportsmagneticHeading
.
La headingAccuracy
propriété est toujours 0 car il n'y a pas de différence entre la magneticHeading
ettrueHeading
.
La trueHeading
propriété n'est pas pris en charge, mais la même valeur que des rapportsmagneticHeading
.
La headingAccuracy
propriété est toujours 0 car il n'y a pas de différence entre la magneticHeading
ettrueHeading
.
trueHeading
propriété est retournée uniquement pour les services de localisation activées vianavigator.geolocation.watchLocation()
.A CompassError
objet est retourné à la compassError
fonction de rappel lorsqu'une erreur survient.
CompassError.COMPASS_INTERNAL_ERR
CompassError.COMPASS_NOT_SUPPORTED