altimeter
来自于:APICloud 官方立即使用
isSupported startRelativeAltitudeUpdates stopRelativeAltitudeUpdates
概述
本模块封装了获取手机内置气压传感器数据的相关功能。可用手机直接获取当前所处环境的气压值。
气压计实际上叫测高仪,因为气压主要与海拔高度有关。气压计的硬件在手机内部,主要是检测大气压强(kPa)的,而大气压强由于海拔高度有关。气压计不是检测风速的,不要以为对着手机吹气,气压值就会变化。另外,传感器不属于隐私功能,不需要授权。
在 iOS 端,气压计是 iPhone6 开始加入的硬件,不支持 iPhone6 以前的机型。最低支持系统版本是:iOS 8.0 在 android 端 需要根据isSupported方法返回的布尔类型来判断手机是否可以使用,true为可用,false为不可用
isSupported
判断当前设备是否支持气压计
isSupported(callback(ret))
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
{
status: //布尔类型;是否支持,true|false
}
示例代码
var altimeter = api.require('altimeter');
altimeter.isSupported(function(ret) {
if (ret.status) {
alert('支持');
}
});
可用性
iOS 系统,android 系统
可提供的 1.0.0 及更高版本
startRelativeAltitudeUpdates
开始获取海拔、气压值
startRelativeAltitudeUpdates(callback(ret))
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
{
status:, //布尔类型;是否获取成功
altitude:, //数字类型;开始获取气压时到本次获取之间的海拔高度差,单位 m
pressure: //数字类型;气压值,单位 kPa
}
示例代码
var altimeter = api.require('altimeter');
altimeter.startRelativeAltitudeUpdates(function(ret) {
if (ret) {
alert(JSON.stringify(ret));
}
});
可用性
iOS 系统,android 系统
可提供的 1.0.0 及更高版本
stopRelativeAltitudeUpdates
停止获取气压
stopRelativeAltitudeUpdates()
示例代码
var altimeter = api.require('altimeter');
altimeter.stopRelativeAltitudeUpdates();
可用性
iOS 系统,android 系统
可提供的 1.0.0 及更高版本