Questo plugin consente di accedere alla bussola del dispositivo. La bussola è un sensore che rileva la direzione o la voce che il dispositivo è puntato, in genere dalla parte superiore del dispositivo. Esso misura la rotta in gradi da 0 a 359.99, dove 0 è a nord.
L'accesso avviene tramite un oggetto globale navigator.compass.
Anche se l‘oggetto è associato con ambito globale del navigator, non è disponibile fino a dopo l’evento deviceready.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.compass);
}
cordova plugin add cordova-plugin-device-orientation
Ottenere la corrente della bussola. La bussola viene restituita tramite un oggetto CompassHeading utilizzando la funzione di callback compassSuccess.
navigator.compass.getCurrentHeading(compassSuccess, compassError);
function onSuccess(heading) {
alert('Heading: ' + heading.magneticHeading);
};
function onError(error) {
alert('CompassError: ' + error.code);
};
navigator.compass.getCurrentHeading(onSuccess, onError);
Ottiene il titolo attuale del dispositivo a intervalli regolari. Ogni volta che viene recuperato il titolo, viene eseguita la funzione di callback headingSuccess.
L‘orologio restituito ID fa riferimento l’intervallo orologio bussola. L'ID di orologio utilizzabile con navigator.compass.clearWatch a smettere di guardare la navigator.compass.
var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);
compassOptions può contenere i seguenti tasti:
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);
I valori per la rubrica attuale sono generati casualmente al fine di simulare la bussola.
Solo un watchHeading può essere in effetti una volta in iOS. Se un watchHeading utilizza un filtro, chiamata getCurrentHeading o watchHeading utilizza il valore di filtro esistenti per specificare le modifiche intestazione. Guardando i cambiamenti di direzione con un filtro è più efficiente con intervalli di tempo.
filternon è supportato.filter.filter.filter.filter.Smettere di guardare la bussola a cui fa riferimento il parametro ID orologio.
navigator.compass.clearWatch(watchID);
navigator.compass.watchHeading.var watchID = navigator.compass.watchHeading(onSuccess, onError, options); // ... later on ... navigator.compass.clearWatch(watchID);
Alla funzione di callback compassSuccess viene restituito un oggetto CompassHeading.
magneticHeading: la rotta in gradi da 0-359.99 in un unico momento. (Numero)
trueHeading: la voce rispetto al Polo Nord geografico in gradi 0-359.99 in un unico momento. Un valore negativo indica che non è possibile determinare la vera voce. (Numero)
headingAccuracy: lo scostamento in gradi tra il titolo segnalato e la vera voce. (Numero)
timestamp: il tempo in cui questa voce è stata determinata. (millisecondi)
trueHeadingnon è supportato, ma riporta lo stesso valoremagneticHeading
headingAccuracyè sempre 0 perché non non c'è alcuna differenza tra la magneticHeading etrueHeading
La trueHeading proprietà non è supportata, ma riporta lo stesso valoremagneticHeading.
La headingAccuracy proprietà è sempre 0 perché non non c'è alcuna differenza tra la magneticHeading etrueHeading.
La trueHeading proprietà non è supportata, ma riporta lo stesso valoremagneticHeading.
La headingAccuracy proprietà è sempre 0 perché non non c'è alcuna differenza tra la magneticHeading etrueHeading.
trueHeading proprietà viene restituito solo per servizi di localizzazione attivate tramitenavigator.geolocation.watchLocation().Un oggetto CompassError viene restituito alla funzione di callback compassError quando si verifica un errore.
CompassError.COMPASS_INTERNAL_ERRCompassError.COMPASS_NOT_SUPPORTED