PhoneGap API帮助文档翻译—Accelerometer (加速度计) PhoneGap API帮助文档翻译—Accelerometer (加速度计)

samwong

浏览: 282286 次
性别:
来自: 北京

最近访客更多访客>>

wenjinshan

ShangJinDeLiuMang

dotfeng

kingrom

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

PhoneGap API帮助文档翻译—Accelerometer (加速度计)

“采集设备在x、y、z方向上的动作。

方法：

accelerometer.getCurrentAcceleration
accelerometer.watchAcceleration
accelerometer.clearWatch

参数：

accelerometerSuccess
accelerometerError
accelerometerOptions

对象（只读）：

Acceleration

accelerometer.getCurrentAcceleration

返回当前沿x、y和z方向的加速度。

说明：

加速计是检测设备在当前方向上所做相对运动变化（增、减量）的运动传感器。加速计可以检测沿X、Y和Z轴的三维运动。

加速度数据通过accelerometerSuccess回调函数返回。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

iPhone的特异情况：

iPhone没有获取在任何给定点当前加速度数据的概念。
你必须通过给定时间间隔查看加速度并获得数据。
因此，getCurrentAcceleration函数会返回从phoneGap watchAccelerometer调用开始后的最近一个返回值

accelerometer.watchAcceleration

在固定的时间间隔获取沿x、y和z轴的加速度。

说明：

加速计是检测设备在当前方向上所做相对运动变化（增、减量）的动作传感器。加速计可以检测沿X、Y和Z轴的三维运动。

accelerometer.watchAcceleration每隔固定时间就获取一次设备的当前加速度。每次取得加速度后，accelerometerSuccess回调函数会被执行。通过acceleratorOptions对象的frequency参数可以设定以毫秒为单位的时间间隔。

返回的watch id是加速度计监视周期的引用，可以通过accelerometer.clearWatch调用该watch ID以停止对加速度计的监视。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
	
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
 
	// watch id 是当前“watchAcceleration”的引用
	var watchID = null;
	
	// 等待加载PhoneGap
	document.addEventListener("deviceready", onDeviceReady, false);
	
	// PhoneGap加载完毕
	function onDeviceReady() {
		startWatch();
	}
	
	// 开始监视加速度
	function startWatch() {
	
	// 每隔3秒钟更新一次加速度数据
	var options = { frequency: 3000 };
	
	watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
	}
	
	// 停止监视加速度
	function stopWatch() {
		if (watchID) {
			navigator.accelerometer.clearWatch(watchID);
			watchID = null;
		}
	}
	
	// onSuccess: 获取当前加速度数据的快照
	function onSuccess(acceleration) {
		var element = document.getElementById('accelerometer');
		element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
							'Acceleration Y: ' + acceleration.y + '<br />' +
							'Acceleration Z: ' + acceleration.z + '<br />' +
							'Timestamp: '      + acceleration.timestamp + '<br />';
	}
	
	// onError: 获取加速度失败
	function onError() {
		alert('onError!');
	}
	
</script>
 
</head>
<body>
	<div id="accelerometer">Waiting for accelerometer...</div>
</body>
</html>

iPhone的特异情况：

在请求的时间间隔，PhoneGap将调用success回调指向的函数，并传递加速度计数据。
不过，PhoneGap将对设备的请求间隔时间限制为最小40ms，最大1000ms。
例如，如果你设定每隔3秒（3000毫秒）请求一次，PhoneGap仍然每隔1秒请求一次设备，但是每隔3秒才调用一次success回调函数。

accelerometer.clearWatch

停止watch ID参数指向的加速度监视。

watchID：由accelerometer.watchAcceleration返回的引用标识ID。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
 
	// watch id 是当前“watchAcceleration”的引用
	var watchID = null;
	
	// 等待加载PhoneGap
	document.addEventListener("deviceready", onDeviceReady, false);
	
	// PhoneGap加载完毕
	function onDeviceReady() {
		startWatch();
	}
	
	// 开始监视加速度
	function startWatch() {
	
		// 每隔3秒钟更新一次加速度数据
		var options = { frequency: 3000 };
		watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
	}
	
	// 停止监视加速度
	function stopWatch() {
		if (watchID) {
			navigator.accelerometer.clearWatch(watchID);
			watchID = null;
		}
	}
	
	// onSuccess: 获取当前加速度数据的快照
	function onSuccess(acceleration) {
		var element = document.getElementById('accelerometer');
		element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
							'Acceleration Y: ' + acceleration.y + '<br />' +
							'Acceleration Z: ' + acceleration.z + '<br />' +
							'Timestamp: '      + acceleration.timestamp + '<br />';
	}
	
	// onError: 获取加速度失败
	function onError() {
		alert('onError!');
	}
	
</script>
</head>
<body>
	<div id="accelerometer">Waiting for accelerometer...</div>
	<button onclick="stopWatch();">Stop Watching</button>
</body>
</html>

Acceleration

包含特定时间点采集到的加速计数据。

属性：

x：在X轴的运动量，[0, 1]范围（数字类型）
y：在Y轴的运动量，[0, 1]范围（数字类型）
z：在Z轴的运动量，[0, 1]范围（数字类型）
timestamp：以毫秒为单位的创建时间戳。（DOMTimeStamp类型）

说明：

这个对象是由phoneGap创建和填充，并由Acce这个对象是由PhoneGap创建和填充，并由Accelerometer的方法返回。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

accelerometerSuccess

提供加速度信息的onSuccess回调函数。

参数：

acceleration：在某一时刻的加速度(Acacceleration：在某一时刻的加速度。(Acceleration对象类型)

accelerometerError

加速度方法的onError回调函数。

accelerometerOptions

定制检索加速度计的可选参数。

选项：

frequency：多少毫秒获取一次Acceleration。（数字类型）（默认值：10000）

“采集设备在x、y、z方向上的动作。

方法：

accelerometer.getCurrentAcceleration
accelerometer.watchAcceleration
accelerometer.clearWatch

参数：

accelerometerSuccess
accelerometerError
accelerometerOptions

对象（只读）：

Acceleration

accelerometer.getCurrentAcceleration

返回当前沿x、y和z方向的加速度。

说明：

加速计是检测设备在当前方向上所做相对运动变化（增、减量）的运动传感器。加速计可以检测沿X、Y和Z轴的三维运动。

加速度数据通过accelerometerSuccess回调函数返回。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

iPhone的特异情况：

iPhone没有获取在任何给定点当前加速度数据的概念。
你必须通过给定时间间隔查看加速度并获得数据。
因此，getCurrentAcceleration函数会返回从phoneGap watchAccelerometer调用开始后的最近一个返回值

accelerometer.watchAcceleration

在固定的时间间隔获取沿x、y和z轴的加速度。

说明：

加速计是检测设备在当前方向上所做相对运动变化（增、减量）的动作传感器。加速计可以检测沿X、Y和Z轴的三维运动。

返回的watch id是加速度计监视周期的引用，可以通过accelerometer.clearWatch调用该watch ID以停止对加速度计的监视。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

iPhone的特异情况：

在请求的时间间隔，PhoneGap将调用success回调指向的函数，并传递加速度计数据。
不过，PhoneGap将对设备的请求间隔时间限制为最小40ms，最大1000ms。
例如，如果你设定每隔3秒（3000毫秒）请求一次，PhoneGap仍然每隔1秒请求一次设备，但是每隔3秒才调用一次success回调函数。

accelerometer.clearWatch

停止watch ID参数指向的加速度监视。

watchID：由accelerometer.watchAcceleration返回的引用标识ID。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">
 
	// watch id 是当前“watchAcceleration”的引用
	var watchID = null;
	
	// 等待加载PhoneGap
	document.addEventListener("deviceready", onDeviceReady, false);
	
	// PhoneGap加载完毕
	function onDeviceReady() {
		startWatch();
	}
	
	// 开始监视加速度
	function startWatch() {
	
		// 每隔3秒钟更新一次加速度数据
		var options = { frequency: 3000 };
		watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
	}
	
	// 停止监视加速度
	function stopWatch() {
		if (watchID) {
			navigator.accelerometer.clearWatch(watchID);
			watchID = null;
		}
	}
	
	// onSuccess: 获取当前加速度数据的快照
	function onSuccess(acceleration) {
		var element = document.getElementById('accelerometer');
		element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
							'Acceleration Y: ' + acceleration.y + '<br />' +
							'Acceleration Z: ' + acceleration.z + '<br />' +
							'Timestamp: '      + acceleration.timestamp + '<br />';
	}
	
	// onError: 获取加速度失败
	function onError() {
		alert('onError!');
	}
	
</script>
</head>
<body>
	<div id="accelerometer">Waiting for accelerometer...</div>
	<button onclick="stopWatch();">Stop Watching</button>
</body>
</html>

Acceleration

包含特定时间点采集到的加速计数据。

属性：

x：在X轴的运动量，[0, 1]范围（数字类型）
y：在Y轴的运动量，[0, 1]范围（数字类型）
z：在Z轴的运动量，[0, 1]范围（数字类型）
timestamp：以毫秒为单位的创建时间戳。（DOMTimeStamp类型）

说明：

这个对象是由phoneGap创建和填充，并由Acce这个对象是由PhoneGap创建和填充，并由Accelerometer的方法返回。

支持的平台：

Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：

完整的范例：

accelerometerSuccess

提供加速度信息的onSuccess回调函数。

参数：

acceleration：在某一时刻的加速度(Acacceleration：在某一时刻的加速度。(Acceleration对象类型)

accelerometerError

加速度方法的onError回调函数。

accelerometerOptions

定制检索加速度计的可选参数。

选项：

frequency：多少毫秒获取一次Acceleration。（数字类型）（默认值：10000）

分享到：

PhoneGap API帮助文档翻译—Camera (摄像头 ...

2012-02-01 23:01
浏览 594
评论(0)
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

PhoneGap API帮助文档翻译—Accelerometer (加速度计) PhoneGap API帮助文档翻译—Accelerometer (加速度计)

PhoneGap API帮助文档翻译—Accelerometer (加速度计)

评论

发表评论

相关推荐

最近访客 更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

PhoneGap API帮助文档翻译—Accelerometer (加速度计) PhoneGap API帮助文档翻译—Accelerometer (加速度计)

PhoneGap API帮助文档翻译—Accelerometer (加速度计)

评论

发表评论

相关推荐

最近访客更多访客>>