accelerometer


简介:

Accelerometer模块管理设备加速度传感器,用于获取感应手机的运动的信息,包括x(屏幕水平方向)、y(垂直屏幕水平方向)、z(垂直屏幕平面方向)三个方向的加速度信息。通过rd.accelerometer获取设备加速度传感器管理对象。

方法:

回调方法:

getCurrentAcceleration


获取当前设备的加速度信息

rd.accelerometer.getCurrentAcceleration(AccelerometerSuccessCallback, AccelerometerErrorCallback);
说明:

加速度是设备在当前方向上所做相对运动变化(增、减量)的运动传感器。加速度信息包括x、y、z三个方向的信息。 加速度信息可通过AccelerometerSuccessCallback回调函数返回。加速度信息获取失败则调用回调函数AccelerometerErrorCallback。

参数:
  • AccelerometerSuccessCallback(): 必选 获取设备加速度信息成功回调函数
  • AccelerometerErrorCallback(): 必选 获取设备加速度信息失败回调函数
返回值:

示例:
function test(){
    rd.accelerometer.getCurrentAcceleration(AccelerometerSuccessCallback,AccelerometerErrorCallback);
}
function AccelerometerSuccessCallback(a){//获取设备加速度信息成功的回调函数
    var x = a.xAxis;
    var y = a.yAxis;
    var z = a.zAxis;
}
function AccelerometerErrorCallback(error){//获取设备加速度信息失败的回调函数

}

AccelerometerSuccessCallback


获取设备加速度信息成功的回调函数

function AccelerometerSuccessCallback(acceleration) {
    var x = acceleration.xAxis;
    var y = acceleration.yAxis;
    var z = acceleration.zAxis;
}
参数:
  • acceleration:(JSON) 必选 设备的加速度信息 Acceleration类型对象,用于获取各方向的详细加速度值。
    • xAxis : (Number )x轴方向的加速度 获取当前设备x轴方向的加速度,浮点型数据,与物理学中的加速度值一致。
    • yAxis : (Number )y轴方向的加速度 获取当前设备y轴方向的加速度,浮点型数据,与物理学中的加速度值一致。
    • zAxis : (Number )z轴方向的加速度 获取当前设备z轴方向的加速度,浮点型数据,与物理学中的加速度值一致。
返回值:

AccelerometerErrorCallback


获取设备加速度信息失败的回调函数

function AccelerometerErrorCallback( error ) {
// Handle error
}
参数:
  • error: ( String ) 必选 获取加速度操作的错误信息
返回值:

watchAcceleration


监听设备加速度变化信息

说明:

加速度是设备在当前方向上所做相对运动变化(增、减量)的运动传感器。加速度信息包括x、y、z三个方向的信息。 watchAcceleration每隔固定时间就获取一次设备的加速度信息,通过AccelerometerSuccessCallback 回调函数返回。可通过option的frequency参数设定获取设备加速度信息的时间间隔。 加速度信息获取失败则调用回调函数AccelerometerErrorCallback。

参数:
  • AccelerometerSuccessCallback: 必选 成功回调函数 当获取设备的加速度信息成功时回调,并返回加速度信息。
  • AccelerometerErrorCallback: 必选 失败回调函数 当获取设备加速度信息失败回调函数,并返回错误信息。
  • option:(JSON)可选 加速度信息参数 监听设备加速度信息的参数,更新数据的频率。
    • frequency: (Number )更新加速度信息间隔时间 监听器获取加速度信息的时间间隔,单位为ms,默认值为500ms
返回值:

示例:
function test(){
    var option = {frequency:500};
    rd.accelerometer.watchAcceleration(AccelerometerSuccessCallback,AccelerometerErrorCallback,option);
};
function AccelerometerSuccessCallback(a){//获取设备加速度信息成功的回调函数
    var x = a.xAxis;
    var y = a.yAxis;
    var z = a.zAxis;
}
function AccelerometerErrorCallback(error){//获取设备加速度信息失败的回调函数

}
clearWatch

关闭监听设备加速度信息

rd.accelerometer.clearWatch();
说明:

关闭监听设备加速度信息,应用关闭调用watchAcceleration方法的开启的监听操作。

参数:

返回值:

示例:
rd.accelerometer.clearWatch();