gyro
来自于:开发者立即使用
checkUp startListener stopListener
概述
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系统