方法:
accelerometer.getCurrentAcceleration
accelerometer.watchAcceleration
accelerometer.clearWatch
参数:
accelerometerSuccess
accelerometerError
accelerometerOptions
对象(只读):
Acceleration
accelerometer.getCurrentAcceleration
返回当前沿x、y和z方向的加速度。
复制navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);
1.
说明:
加速计是检测设备在当前方向上所做相对运动变化(增、减量)的运动传感器。加速计可以检测沿X、Y和Z轴的三维运动。
加速度数据通过accelerometerSuccess回调函数返回。
支持的平台:
Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
简单的范例:
复制function onSuccess(acceleration) {
alert(Acceleration X: + acceleration.x + \n +
Acceleration Y: + acceleration.y + \n +
Acceleration Z: + acceleration.z + \n +
Timestamp: + acceleration.timestamp + \n);
}
function onError() {
alert(onError!);
}
navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
1.2.3.4.5.6.7.8.9.10.11.12.
完整的范例:
复制<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
<scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script>
<scripttype="text/javascript"charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
}
// onSuccess: 返回当前加速度数据的快照
function onSuccess(acceleration) {
alert(Acceleration X: + acceleration.x + \n +
Acceleration Y: + acceleration.y + \n +
Acceleration Z: + acceleration.z + \n +
Timestamp: + acceleration.timestamp + \n);
}
// onError: 返回加速度数据失败
function onError() {
alert(onError!);
}
</script>
</head>
<body>
<h1>Example</h1>
<p>getCurrentAcceleration</p>
</body>
</html>
1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.
iPhone的特异情况:
iPhone没有获取在任何给定点当前加速度数据的概念。
你必须通过给定时间间隔查看加速度并获得数据。
因此,getCurrentAcceleration函数会返回从phoneGap watchAccelerometer调用开始后的最近一个返回值。
accelerometer.watchAcceleration
在固定的时间间隔获取沿x、y和z轴的加速度。
复制var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
accelerometerError,
[accelerometerOptions]);
1.2.3.
说明:
加速计是检测设备在当前方向上所做相对运动变化(增、减量)的动作传感器。加速计可以检测沿X、Y和Z轴的三维运动。
accelerometer.watchAcceleration每隔固定时间就获取一次设备的当前加速度。每次取得加速度后,accelerometerSuccess回调函数会被执行。通过acceleratorOptions对象的frequency参数可以设定以毫秒为单位的时间间隔。
返回的watch id是加速度计监视周期的引用,可以通过accelerometer.clearWatch调用该watch ID以停止对加速度计的监视。
支持的平台:
Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
简单的范例:
复制function onSuccess(acceleration) {
alert(Acceleration X: + acceleration.x + \n +
Acceleration Y: + acceleration.y + \n +
Acceleration Z: + acceleration.z + \n +
Timestamp: + acceleration.timestamp + \n);
}
function onError() {
alert(onError!);
}
var options = { frequency: 3000 }; // 每隔3秒更新一次
var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
1.2.3.4.5.6.7.8.9.10.11.12.13.14.
完整的范例:
复制<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
<scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script>
<scripttype="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>
<divid="accelerometer">Waiting for accelerometer...</div>
</body>
</html>
1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.37.38.39.40.41.42.43.44.45.46.47.48.49.50.51.52.53.54.55.56.
iPhone的特异情况:
在请求的时间间隔,PhoneGap将调用success回调指向的函数,并传递加速度计数据。
不过,PhoneGap将对设备的请求间隔时间限制为最小40ms,***1000ms。
例如,如果你设定每隔3秒(3000毫秒)请求一次,PhoneGap仍然每隔1秒请求一次设备,但是每隔3秒才调用一次success回调函数。
accelerometer.clearWatch
停止watch ID参数指向的加速度监视。
复制navigator.accelerometer.clearWatch(watchID);
1.
watchID:由accelerometer.watchAcceleration返回的引用标识ID。
支持的平台:
Android
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone
简单的范例:
复制var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
// ... 后续处理 ...
navigator.accelerometer.clearWatch(watchID);
1.2.3.4.5.
完整的范例:
复制<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
<scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script>
<scripttype="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>
<divid="accelerometer">Waiting for accelerometer...</div>
<buttononclick="stopWatch();">Stop Watching</button>
</body>
</html>
1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.37.38.39.40.41.42.43.44.45.46.47.48.49.50.51.52.53.54.55.56.
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
简单的范例:
复制function onSuccess(acceleration) {
alert(Acceleration X: + acceleration.x + \n +
Acceleration Y: + acceleration.y + \n +
Acceleration Z: + acceleration.z + \n +
Timestamp: + acceleration.timestamp + \n);
}
function onError() {
alert(onError!);
}
navigator.accelerometer.getCurrentAcceleration(onSuccess,onError);
1.2.3.4.5.6.7.8.9.10.11.12.
完整的范例:
复制<!DOCTYPE html>
<html>
<head>
<title>Acceleration Example</title>
<scripttype="text/javascript"charset="utf-8"src="phonegap.js"></script>
<scripttype="text/javascript"charset="utf-8">
// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);
// PhoneGap加载完毕
function onDeviceReady() {
navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
}
// onSuccess: 获得加速度数据的快照
function onSuccess(acceleration) {
alert(Acceleration X: + acceleration.x + \n +
Acceleration Y: + acceleration.y + \n +
Acceleration Z: + acceleration.z + \n +
Timestamp: + acceleration.timestamp + \n);
}
// onError: 获取加速度失败
function onError() {
alert(onError!);
}
</script>
</head>
<body>
<h1>Example</h1>
<p>getCurrentAcceleration</p>
</body>
</html>
1.2.3.4.5.6.7.8.9.10.11.12.13.14.15.16.17.18.19.20.21.22.23.24.25.26.27.28.29.30.31.32.33.34.35.36.
accelerometerSuccess
提供加速度信息的onSuccess回调函数。
复制function(acceleration) {
// 进一步处理
}
1.2.3.
参数:
acceleration: 在某一时刻的加速度(Acacceleration:在某一时刻的加速度。(Acceleration对象类型)
复制function onSuccess(acceleration) {
alert(Acceleration X: + acceleration.x + \n +
Acceleration Y: + acceleration.y + \n +
Acceleration Z: + acceleration.z + \n +
Timestamp: + acceleration.timestamp + \n);
}
1.2.3.4.5.6.
accelerometerError
加速度方法的onError回调函数。
复制function() {
// 错误处理
}
1.2.3.
accelerometerOptions
定制检索加速度计的可选参数。
选项:
frequency:多少毫秒获取一次Acceleration。(数字类型)(默认值:10000)
暂时没有评论,来抢沙发吧~