文章来自:http://blog.csdn.net/phonegapcn/article/details/6695518
获得该设备的当前朝向。
方法：
- compass.getCurrentHeading
- compass.watchHeading
- compass.clearWatch
参数：
- compassSuccess
- compassError
- compassOptions
compass.getCurrentHeading:获取罗盘的当前朝向。
navigator.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() {
alert('onError!');
}
var options = { frequency: 3000 }; //每隔3秒更新一次
var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Compass Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// watchID 是当前“watchHeading”的引用
var watchID = null;
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
startWatch();
}
// 开始监视罗盘
function startWatch() {
// 每隔3秒钟更新一次罗盘的朝向信息
var options = { frequency: 3000 };
watchID = navigator.compass.watchHeading(onSuccess, onError, options);
}
// 停止监视罗盘
function stopWatch() {
if (watchID) {
navigator.compass.clearWatch(watchID);
watchID = null;
}
}
// onSuccess: 返回罗盘的当前朝向
function onSuccess(heading) {
var element = document.getElementById('heading');
element.innerHTML = 'Heading: ' + heading;
}
// onError: 获取罗盘朝向失败
function onError() {
alert('onError!');
}
</script>
</head>
<body>
<div id="heading">Waiting for heading...</div>
<button onclick="startWatch();">Start Watching</button>
<button onclick="stopWatch();">Stop Watching</button>
</body>
</html>
compass.clearWatch:停止watch ID参数指向的罗盘监视.
navigator.compass.clearWatch(watchID);
watchID： 由compass.watchHeading返回的引用标示。
支持的平台：
- Android
- iPhone
简单的范例：
var watchID = navigator.compass.watchHeading(onSuccess, onError, options);
// ... 后继处理 ...
navigator.compass.clearWatch(watchID);
完整的范例：
<!DOCTYPE html>
<html>
<head>
<title>Compass Example</title>
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
// watchID是当前 “watchHeading” 的引用
var watchID = null;
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
startWatch();
}
// 开始监视罗盘
function startWatch() {
// 每隔3秒钟更新一次罗盘数据
var options = { frequency: 3000 };
watchID = navigator.compass.watchHeading(onSuccess, onError, options);
}
// 停止监视罗盘
function stopWatch() {
if (watchID) {
navigator.compass.clearWatch(watchID);
watchID = null;
}
}
// onSuccess: 返回罗盘的当前朝向
function onSuccess(heading) {
var element = document.getElementById('heading');
element.innerHTML = 'Heading: ' + heading;
}
// onError: 获取罗盘朝向失败
function onError() {
alert('onError!');
}
</script>
</head>
<body>
<div id="heading">Waiting for heading...</div>
<button onclick="startWatch();">Start Watching</button>
<button onclick="stopWatch();">Stop Watching</button>
</body>
</html>
compassSuccess:提供罗盘朝向信息的onSuccess回调函数。
参数：
- heading：在某一时刻的罗盘朝向角度 (从0度到359.99度之间)。（数字类型）
| compassOptions |
定制检索罗盘朝向的可选参数。
选项：
- frequency：多少毫秒获取一次罗盘朝向。（数字类型）（默认值：100）
相关推荐
标题：PhoneGap,API帮助文档翻译整理4-Compass(指南针) 描述：本文档将深入探讨PhoneGap中Compass API的功能与应用，包括如何获取设备的指南针方向、监听指南针变化以及如何处理相关事件。 ### 一、Compass API...
这个"PhoneGap API帮助文档.zip"压缩包显然包含了关于如何使用PhoneGap API的详细指南，对于开发者来说是非常宝贵的资源。下面我们将深入探讨PhoneGap API中的关键组件及其功能。 1. **加速度计（Accelerometer）**...
网上的phonegap中文帮助文档尚少，翻译也不太好，在此收集了一些翻译优秀的文章，并制作成chm的帮助文档，以帮助各位学习,此文档包含了phonegap的主要使用功能，并提供了完整示例
### PhoneGap Contacts API详解 #### 一、简介 在移动应用开发中，有时我们需要访问用户的通讯录以便于实现社交功能或其他交互式应用需求。PhoneGap（现称Cordova）为开发者提供了一套丰富的API，使得跨平台应用...
PhoneGap API 提供了一系列的事件，这些事件可以帮助开发者响应移动设备上的特定操作，从而实现更丰富的用户体验。本文将详细介绍 PhoneGap 中的事件类型及其使用方法。 1. **backbutton**：当用户在 Android 设备...
在本篇文档中，我们关注的是 PhoneGap 的 Media API，它提供了对移动设备媒体（如音频）的访问和控制能力。 Media API 提供了对音频文件的操作，包括播放、暂停、停止以及获取当前播放位置等功能。以下是对 Media ...
知识点：PhoneGap设备API及其应用 一、PhoneGap设备API概览 PhoneGap是一个开源框架，允许开发者使用HTML、CSS和JavaScript开发跨平台移动应用程序。设备API是PhoneGap提供的核心功能之一，它允许开发者访问设备的...
最新的Phonegap api 中文翻译版。让你快速入门。
知识点：PhoneGap的Camera API详解 一、PhoneGap与Camera API简介 PhoneGap是一个开源框架，允许开发者使用HTML，CSS和JavaScript开发跨平台移动应用程序。它通过提供一系列API来访问设备的功能，如摄像头、GPS、...
在本文中，我们将围绕PhoneGap框架的API文档进行探讨，特别是在处理移动设备上的通讯录（Contacts）数据时所使用的一系列方法。根据提供的文件信息，我们将会详细解释如何使用PhoneGap API来创建和查找通讯录中的...
在本篇文档中，我们将重点关注与“文件”相关的 API，包括 `File`、`DirectoryEntry`、`FileReader` 等。 **File API** 是一组用于读取、写入和管理设备文件系统层级结构的接口。这些接口遵循 W3C 的《文件系统 API...
### PhoneGap Capture API详解 #### 一、简介 **PhoneGap**是一款开源框架，允许开发者使用HTML、CSS和JavaScript等Web技术开发跨平台移动应用程序。本文档主要介绍**PhoneGap**中的**Capture API**，该API提供了...
// PhoneGap 激活时执行 function onDeviceReady() { // 不使用超时，因为不是必需的 // 如果在设备准备好之前调用了 getCurrentPosition，将会失败 navigator.geolocation.getCurrentPosition(onSuccess, on...
### PhoneGap中的Accelerometer（加速度计）API详解 #### 一、简介 加速度计是一种常见的硬件传感器，被广泛应用于智能手机和平板电脑等移动设备上。它主要用于测量设备在三维空间中的线性加速度，通常包括三个轴...
PhoneGap是一种跨平台的移动应用开发框架，它允许开发者使用HTML、CSS和JavaScript来构建原生的移动应用程序。...理解并熟练使用这些API，结合Android平台的具体实践，能够帮助你构建出功能完善的移动应用。
本手册为PhoneGap API的中文版指南，旨在为开发者提供全面、详细的API使用指导，帮助其利用PhoneGap框架开发跨平台移动应用。PhoneGap是一款基于HTML、CSS和JavaScript的技术栈，允许开发者构建适用于多个移动操作...
在PhoneGap中，事件处理是连接用户交互与应用程序逻辑的关键环节，让我们深入探讨PhoneGap API中的事件处理机制。 1. **事件模型**：PhoneGap遵循W3C的DOM事件模型，包括事件监听器、事件冒泡和事件捕获。事件监听...
总的来说，PhoneGap API中文版对于想要使用Web技术开发跨平台移动应用的开发者来说，是一个重要的学习和参考资源，可以帮助他们更高效地理解和利用PhoneGap的功能。通过深入学习和实践，开发者可以创建出功能丰富的...
CHM文件是一种常见的Windows帮助文档格式，其中包含了丰富的信息和教程，方便用户查阅。 在PhoneGap中，以下是一些关键的知识点： 1. **环境配置**：首先，你需要安装PhoneGap CLI（命令行界面）和相关的平台SDK...