gyro

来自于:开发者立即使用

概述

gyro 模块概述

gyro封装了iOS系统的陀螺仪,使用此模块可轻松实现对各个方向旋转速率获取的功能。

模块接口

checkUp

检查设备是否有陀螺仪

checkUp(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    code:              //0代表设备有陀螺仪,1代表设备没有陀螺仪

}

err:

  • 类型:JSON 对象
  • 内部字段:
{
                    //无返回值
}

示例代码

var gyro= api.require('gyro');
gyro.checkUp(function(ret,err){
    alert(JSON.stringify(ret));
});

可用性

iOS系统

startListener

打开重力感应

startListener({params}, callback(ret, err))

params

time:

  • 类型:字符串
  • 描述:(必选)采集信息间隔时间,以秒为单位。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    x:              //速率绕x轴的旋转(弧度/秒)
    y:              //速率绕y轴的旋转(弧度/秒)
    z:              //速率绕z轴的旋转(弧度/秒)
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
                    //无返回值
}

示例代码

var gyro= api.require('gyro');
gyro.startListener({
    time : '0.1'
},function(ret, err){
    var msg =  JSON.stringify(ret);
    api.toast({
        msg: msg
    });
});

补充说明

经过测试,当间隔时间设置较长时,5s机型第一返回值时间会变长,建议设置0.1秒。

可用性

iOS系统

可提供的1.0.0及更高版本

stopListener

关闭重力感应

stopListener()

示例代码

var gyro = api.require('gyro');
gyro.stopListener();

可用性

iOS系统