PhoneGap API中文帮助文档——Compass(罗盘)

来源：网络责任编辑：栏目编辑发表时间:2013-07-01 18:54　点击:次

获得该设备的当前朝向。
方法：
compass.getCurrentHeading
compass.watchHeading
compass.clearWatch

参数：
compassSuccess
compassError
compassOptions

compass.getCurrentHeading
获取罗盘的当前朝向。

简单的范例：
avigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions);
复制代码说明：罗盘是一个检测设备方向或朝向的传感器，使用度作为衡量单位，取值范围从0度到359.99度。
通过compassSuccess回调函数返回罗盘朝向数据

支持的平台：
Android
iPhone

简单的范例：
function onSuccess(heading) { alert('Heading: ' + heading); } function onError() { alert('onError!'); } navigator.compass.getCurrentHeading(onSuccess, onError);
复制代码完整的范例：
<!DOCTYPE html> <html> <head> <SCRIPT type=text/javascript charset=utf-8 src="phonegap.js"></SCRIPT> <SCRIPT type=text/javascript charset=utf-8>

// 等待加载PhoneGap

document.addEventListener("deviceready", onDeviceReady, false);

// PhoneGap加载完毕

function onDeviceReady() {

navigator.compass.getCurrentHeading(onSuccess, onError);

}

// onSuccess: 返回当前的朝向数据

function onSuccess(heading) {

alert('Heading: ' + heading);

}

// onError: 返回朝向数据失败

function onError() {

alert('onError!');

}

</SCRIPT>

</head>

<body>

<h1>Example</h1>

<p>getCurrentHeading</p>

</body>

</html>
复制代码compass.watchHeading 在固定的时间间隔获取罗盘朝向的角度。
var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);
复制代码说明：罗盘是一个检测设备方向或朝向的传感器，使用度作为衡量单位，取值范围从0度到359.99度。
compass.watchHeading每隔固定时间就获取一次设备的当前朝向。每次取得朝向后，headingSuccess回调函数会被执行。通过compassOptions对象的frequency参数可以设定以毫秒为单位的时间间隔。
返回的watch ID是罗盘监视周期的引用，可以通过compass.clearWatch调用该watch ID以停止对罗盘的监视。

支持的平台：
Android
iPhone

简单的范例：
function onSuccess(heading) {

var element = document.getElementById('heading');

element.innerHTML = 'Heading: ' + heading;

}

function onError() {