Эта версия документации устарела!
Нажмите здесь для последней выпущенной версии.
compass.getCurrentHeading
Получите текущий курс.
navigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions);
Описание
Компас является датчик, который определяет направление или заголовок, что устройство указал, обычно из верхней части устройства. Он измеряет направление в градусах от 0 до 359,99 градусов, где 0 — север.
Курс информация возвращается через CompassHeading
объект с помощью [compassSuccess](parameters/compassSuccess.html)
функции обратного вызова.
Поддерживаемые платформы
- Андроид
- Ежевика 10
- iOS
- Tizen
- Windows Phone 7 и 8 (при наличии в аппаратной)
- ОС Windows 8
Быстрый пример
function onSuccess(heading) {
alert('Heading: ' + heading.magneticHeading);
};
function onError(error) {
alert('CompassError: ' + error.code);
};
navigator.compass.getCurrentHeading(onSuccess, onError);
Полный пример
<!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>