介绍

这个插件提供了访问设备的加速度计。加速度计是一个运动传感器检测到的变化&＃xff08;三维维度&＃xff09;在相对运动的当前设备的方向&＃xff0c;在三个维度上沿X&＃xff0c;Y&＃xff0c;和Z坐标轴。用来在三个维度来跟踪设备的运动。

安装

cordova plugin add cordova-plugin-device-motion

支持的平台Supported Platforms

· Amazon Fire OS

· Android

· BlackBerry 10

· Browser

· Firefox OS

· iOS

· Tizen

· Windows Phone 8

· Windows

使用方法

访问是通过一个全局navigator.accelerometer对象

虽然对象连接到全局navigator&＃xff0c;但是需要在deviceready事件之后才可用

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

function onDeviceReady() {

    console.log(navigator.accelerometer);

}

方法Methods

· navigator.accelerometer.getCurrentAcceleration

· navigator.accelerometer.watchAcceleration

· navigator.accelerometer.clearWatch

navigator.accelerometer.getCurrentAcceleration

拿到当前加速度的X&＃xff0c;Y&＃xff0c;和Z轴

这些加速度值返回accelerometerSuccess回调函数

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

Example

function onSuccess(acceleration) {

    alert(&＃39;Acceleration X: &＃39; &＃43; acceleration.x &＃43; &＃39;\n&＃39; &＃43;

          &＃39;Acceleration Y: &＃39; &＃43; acceleration.y &＃43; &＃39;\n&＃39; &＃43;

          &＃39;Acceleration Z: &＃39; &＃43; acceleration.z &＃43; &＃39;\n&＃39; &＃43;

          &＃39;Timestamp: &＃39;      &＃43; acceleration.timestamp &＃43; &＃39;\n&＃39;);

}

function onError() {

    alert(&＃39;onError!&＃39;);

}

navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);

特性

Browser 特性

X、Y、Z运动的值都是随机生成的,以模拟加速度计。

Android 特性

加速度计被称为与SENSOR_DELAY_UI标记&＃xff0c;这限制了最大读出频率之间为20-60赫兹&＃xff0c;这取决于设备。period 的值对应于更高频率将导致重复的样本。更多的细节可以查看Android API指南

iOS 特性

iOS不承认在任何给定的点取当前加速度的概念。

你必须看的加速度和在给定的时间间隔采集数据。

因此&＃xff0c;该getCurrentAcceleration 函数产生的最后一个返回值从调用watchAccelerometer 

navigator.accelerometer.watchAcceleration

检索器的电流加速度定期考核&＃xff0c;accelerometersuccess每一次回调函数。通过指定间隔毫秒acceleratoroptions对象的频率参数.

回看ID引用加速度计的观看间隔&＃xff0c;可以使用navigator.accelerometer.clearwatch停止看加速度计

var watchID &＃61; navigator.accelerometer.watchAcceleration(accelerometerSuccess,

 accelerometerError, accelerometerOptions);

· accelerometerOptions: 下列可选键对象

frequency: 请求调用accelerometerSuccess在毫秒的加速度数据。&＃xff08;数字型&＃xff09;&＃xff08;默认值&＃xff1a;10000&＃xff09;

Example

function onSuccess(acceleration) {

    alert(&＃39;Acceleration X: &＃39; &＃43; acceleration.x &＃43; &＃39;\n&＃39; &＃43;

          &＃39;Acceleration Y: &＃39; &＃43; acceleration.y &＃43; &＃39;\n&＃39; &＃43;

          &＃39;Acceleration Z: &＃39; &＃43; acceleration.z &＃43; &＃39;\n&＃39; &＃43;

          &＃39;Timestamp: &＃39;      &＃43; acceleration.timestamp &＃43; &＃39;\n&＃39;);

}

function onError() {

    alert(&＃39;onError!&＃39;);

}

var options &＃61; { frequency: 3000 };  // Update every 3 seconds

var watchID &＃61; navigator.accelerometer.watchAcceleration(onSuccess, onError, options);

特性

iOS Quirks

在定时请求这个API返回的成功的回调时&＃xff0c;但是限制要求的设备之间的40ms- 1000ms范围。例如&＃xff0c;如果你要求一个3秒的间隔&＃xff0c;&＃xff08;3000ms&＃xff09;&＃xff0c;API从设备每1秒请求数据&＃xff0c;但执行成功回调是每3秒执行一次。

navigator.accelerometer.clearWatch

停止查看加速度引用的watchID 参数.

navigator.accelerometer.clearWatch(watchID);

· watchID: navigator.accelerometer.watchAcceleration返回的ID

Example

var watchID &＃61; navigator.accelerometer.watchAcceleration(onSuccess, onError, options);

// ... later on ...

navigator.accelerometer.clearWatch(watchID);

对象Objects

· Acceleration

 加速度Acceleration

包含加速度计在特定时间点捕获的数据。加速度值包括重力的影响&＃xff08;9.81米/秒^ 2&＃xff09;&＃xff0c;所以当一个平和面对&＃xff0c;X&＃xff0c;Y&＃xff0c;和Z返回值应该是0&＃xff0c;0&＃xff0c;和9.81

属性Properties

· x: 加速度在X轴的坐标。&＃xff08;米/秒^ 2&＃xff09;&＃xff08;数字型&＃xff09;

· y: 加速度在y轴的坐标。&＃xff08;米/秒^ 2&＃xff09;&＃xff08;数字型&＃xff09;

· z: 加速度在Z轴的坐标。&＃xff08;米/秒^ 2&＃xff09;&＃xff08;数字型&＃xff09;

· timestamp: 以毫秒为单位创建时间戳。&＃xff08;DOMTimeStamp&＃xff09;

示例

示例一&＃xff1a;

index.html&＃xff1a;

index.js&＃xff1a;

var app &＃61; {initialize: function() {document.addEventListener(&＃39;deviceready&＃39;, this.onDeviceReady.bind(this), false);},onDeviceReady: function() {var _this &＃61; this;document.getElementById("current").onclick &＃61; function(){_this.getCurrentAcceleration();}document.getElementById("watch").onclick &＃61; function(){_this.getWatchAcceleration();}},// 获取当前加速度getCurrentAcceleration: function(){function onSuccess(acceleration) {console.log(&＃39;Acceleration X: &＃39; &＃43; acceleration.x &＃43; &＃39;\n&＃39; &＃43;&＃39;Acceleration Y: &＃39; &＃43; acceleration.y &＃43; &＃39;\n&＃39; &＃43;&＃39;Acceleration Z: &＃39; &＃43; acceleration.z &＃43; &＃39;\n&＃39; &＃43;&＃39;Timestamp: &＃39; &＃43; acceleration.timestamp &＃43; &＃39;\n&＃39;);}function onError() {console.log(&＃39;onError!&＃39;);}navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);},// 监视加速度&＃xff0c;每隔3秒输出当前加速度getWatchAcceleration: function(){function onSuccess(acceleration) {console.log(&＃39;Acceleration X: &＃39; &＃43; acceleration.x &＃43; &＃39;\n&＃39; &＃43;&＃39;Acceleration Y: &＃39; &＃43; acceleration.y &＃43; &＃39;\n&＃39; &＃43;&＃39;Acceleration Z: &＃39; &＃43; acceleration.z &＃43; &＃39;\n&＃39; &＃43;&＃39;Timestamp: &＃39; &＃43; acceleration.timestamp &＃43; &＃39;\n&＃39;);}function onError() {console.log(&＃39;onError!&＃39;);}var options &＃61; { frequency: 3000 }; // Update every 3 secondsvar watchID &＃61; navigator.accelerometer.watchAcceleration(onSuccess, onError, options);var timmer &＃61; setTimeout(function(){navigator.accelerometer.clearWatch(watchID);},10000);}};app.initialize();

运行&＃xff1a;

点击“获取当前加速度”&＃xff0c;输出内容

点击“监视加速度”&＃xff0c;每隔3秒会输出一个内容