Questa non è la versione più recente della documentazione!
Click here for the latest released version.
compass.getCurrentHeading
Ottenere la corrente della bussola.
navigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions);
Descrizione
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.
Le informazioni della bussola viene restituite tramite una CompassHeading
oggetto utilizzando il [compassSuccess](parameters/compassSuccess.html)
funzione di callback.
Piattaforme supportate
- Android
- BlackBerry 10
- iOS
- Tizen
- Windows Phone 7 e 8 (se disponibili nell'hardware)
- Windows 8
Esempio rapido
function onSuccess(heading) {
alert('Heading: ' + heading.magneticHeading);
};
function onError(error) {
alert('CompassError: ' + error.code);
};
navigator.compass.getCurrentHeading(onSuccess, onError);
Esempio completo
<!DOCTYPE html>
<html>
<head>
<title>Compass Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
document.addEventListener("deviceready", onDeviceReady, false);
// device APIs are available
//
function onDeviceReady() {
navigator.compass.getCurrentHeading(onSuccess, onError);
}
// onSuccess: Get the current heading
//
function onSuccess(heading) {
alert('Heading: ' + heading.magneticHeading);
}
// onError: Failed to get the heading
//
function onError(compassError) {
alert('Compass Error: ' + compassError.code);
}
</script>
</head>
<body>
<h1>Example</h1>
<p>getCurrentHeading</p>
</body>
</html>