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

小桥流水丿小溪 2013-05-02

文章来自: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>
&nbsp;<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度之间)。（数字类型）
范例：
function onSuccess(heading) { alert('Heading: ' + heading); }
 compassError :罗盘方法的onError回调函数。
compassOptions 
 
定制检索罗盘朝向的可选参数。

选项：

  • frequency：多少毫秒获取一次罗盘朝向。（数字类型）（默认值：100）
小桥流水丿小溪

小桥流水丿小溪

相关推荐

Allenmind‘s Blog

听说，Sass和Compass更配哟。来看看Compass的基本用法！之前写了一篇关于Sass基本用法的文章。Sass可以加快CSS的编写效率，让CSS的开发变得更加简单和可维护。但是，想要发挥Sass的全部功力，就需要配合Compass一起使用。Comp

tianzyc / 0评论 2020-02-01

踩坑记录-连接 MongoDB Compass Community 报错

打开”MongoDB Compass Community“软件 点击”connect"按钮时报 MongoDB not running on the provided host and port的错误，如下图：。原因：之前由于工作需要，在host

ThisLX / 0评论 2019-12-11

Compass---Search Engine (2)

默认情况下，Compass使用它自己的基于Lucene的查询分析器。Compass允许配置多个查询分析器，也可以覆盖默认的Compass查询分析器。自定义的查询分析器能用于扩展默认的查询语言支持，通过添加已解析的查询缓冲等等。一个自定义的查询分析器必须实现

ReganHoo / 0评论 2010-03-12

（转载）网站加上站内搜索基于Compass(基于Lucene)实现

作为javaer，作为apache的顶级开源项目lucene应该有所耳闻吧，刚学完lucene，知道了基本使用，学的程度应该到可以使用的地步，但不的不说lucene官方给的文档例子不是很给力的，还好互联网上资料比较丰富！在搜索lucene的过程中，知道了基

hankesi000 / 0评论 2012-05-26

Lucene、Compass学习以及与SSH的整合

个人在学习中采用Struts2 + Hibernate3.2 + Spring2.5 + Compass2.2.0， 一下图片为本次学习中用到的jar包：。Compass是一个Java搜索框架。它封装了Lucene，增加了一些Lucene不支持的特性，支持

momomoniqwer / 0评论 2011-09-26

sass和compass的使用

sass是一种“css预处理器”，而compass是sass的工具包，两者都是ruby实现，所以需要使用的话，先装ruby以及ruby的包管理器gem，然后安装即可。* nested：嵌套缩进的css代码，它是默认值。　　* compact：简洁格式的cs

云端漂移 / 0评论 2015-07-05

在Vue中使用Compass

2018.4.12 重装系统后发现run dev后各种错，发现是因为没有安装Python环境，嘿哈写作动机前端小白，Vue自学Sass自学，Compass甚至刚看到。技术不精，文章有问题的地方欢迎指教，喷作为调味请勿过量添加。网站打算用Vue来作为前端框架

libowen0 / 0评论 2019-06-26

安装 ruby, sass 和 compass

sass 是一个 css 的预处理器, 简写css, 以及CSS的导航, sass 基于 ruby, 需要先安装 ruby 然后在安装 sass. $ apt-get install ruby更换 ruby 源参见 https://gems.ruby-ch

YetsingZ / 0评论 2019-06-25

phonegap系列之API（九）compass 指南针

侦测设备屏幕朝向：

router / 0评论 2013-03-08

struts2+spring+hibernate+compass 实现全文检索

Compass是一流的开放源码JAVA搜索引擎框架，对于你的应用修饰，搜索引擎语义更具有能力。依靠顶级的Lucene搜索引擎，Compass结合了，像Hibernate和Sprin的流行的框架，为你的应用提供了从数据模型和数据源同步改变的搜索力.并且添加了

aikaibo / 0评论 2009-12-31

Sass & Compass 初步使用

compass create [project_name] // 方式2，会创建一个以project_name命名的compass目录config.rb是compass目录的配置文件，可根据个人需求修改（重要）。@include all-icons-

gigipop / 0评论 2019-06-21

《compass-reference》翻译计划之5-- 搜索引擎

CompassCore提供了一个抽象层再加上精彩的Lucene的搜索引擎。在Lucene之上compasscore还提供一些附加的功能，例如，两相交易（事务）管理，快速更新，以及优化。在试图解释compass协同搜索引擎是如何工作之前，我们首先需要理解搜索

喜糖 / 0评论 2008-07-07

《compass-reference》翻译计划之：前言

我打算在学习Compass的同时，把Compass参考手册翻译出来。在翻译时不采取直译的方式，结合自身的想法用容易理解的话描述出来。因本人英文有限，其中一定存在很多不足之处，望大家给予批评指正。前言Compass的目标：使搜索引擎更容易集成到应用中。Com

leshem / 0评论 2008-06-20

sass和compass学习笔记2（compass）

在学习compass之前先看一下compass对compass是如何定义的。compass是一个开源的CSS自动化处理框架，而之前讲的sass是一种css预处理器，类似于less,stylus等。compass包含了各种用于样式的模块，它与sass关系类似

jianqi / 0评论 2019-06-20

sass和compass学习笔记1（sass）

为什么要学习Sass和Compass简单来说，主要目标：使用Sass和compass可以写出更加优秀的CSS. 当然前提是你要首先会写CSS，要不然也不会写出好的Sass和compass，不过也不排除意外。那么到底哪些人需要来学习sass和compass呢

libowen0 / 0评论 2019-06-20

Compass2.2 学习笔记

分类： 检索搜索 2012-01-10 20:49 36人阅读 评论 收藏 举报 学习Compass是个很快速的过程,它不像其他框架需要花很多时间学习它的API和了解它的工作流程.似乎Compass就是两个框架的组合版本.Compass不仅从结构上模仿了H

lqadam / 0评论 2012-06-20

Compass入门及其与Spring、iBatis的整合

开始之前什么是Compass与Spring、iBatis的整合与Lucene的比较经验总结相关资源开始之前本文是Compass的入门指引，通过实例介绍了Compass与iBatis、Spring的整合，适合不了解Compass的读者，但要求读者了解Luce

吾日五省我身 / 0评论 2012-05-16

ExtJS自定义主题（theme）样式详解

ExtJS4对框架进行了重构，其中最重要的就是形成了一个结构及层次分明的组件体系，由这些组件形成了Ext的控件。至此，Ruby就安装完成了。在开始菜单Ruby程序组下，单击“Start Command Prompt with Ruby”，显示命令提示窗口。

Dorissun / 0评论 2013-11-18

关于Sass与Compass的一些笔记

Sass和Compass都是基于Ruby编程语言的命令行工具。要使用它们，你首先需要在电脑中安Ruby，并对电脑的命令行操作有一个基本的理解。Sass和Compass可以安装在Windows、Mac OS和Linux系统中。在Windows中安装Ruby：

AllaboutTeXnique / 0评论 2018-03-05

邂逅Sass和Compass之Sass篇

随着后台人员大量的涌入前端这个行业，CSS又焕发了新的春天，人们开始为CSS加入编程元素，也就是”CSS预处理器。它的基本思想就是用一门专门的编程语言，进行网页样式设计，然后再编译成正常的CSS文件。下面我们结合官方文档和阮一峰老师的用法指南，再次系统的总

编程爱好者联盟 / 0评论 2016-10-14