magnetometer 插件概述
magnetometer封装了iOS系统的磁力感应,使用此插件可轻松实现对可以让你监控在地球的磁场中的变化的功能。
检查设备是否有磁力感应
checkUp(callback(ret, err))
ret:
{
code: //0代表设备有磁力感应,1代表设备没有磁力感应
}
err:
{
//无返回值
}
var magnetometer= api.require('magnetometer');
magnetometer.checkUp(function(ret,err){
alert(JSON.stringify(ret));
});
iOS系统
可提供的1.0.0及更高版本
打开磁力感应
startListener({params}, callback(ret, err))
time:
ret:
{
x: //地磁场强度沿x轴(μT)
y: //地磁场强度沿y轴(μT)
z: //地磁场强度沿z轴(μT)
}
err:
{
//无返回值
}
var magnetometer= api.require('magnetometer');
magnetometer.startListener({
time : '0.1'
},function(ret, err){
var msg = JSON.stringify(ret);
api.toast({
msg: msg
});
});
经过测试,当间隔时间设置较长时,5s机型第一返回值时间会变长,建议设置0.1秒。
iOS系统
可提供的1.0.0及更高版本
关闭磁力感应
stopListener()
var magnetometer = api.require('magnetometer');
magnetometer.stopListener();
iOS系统
可提供的1.0.0及更高版本