altimeter

来自于:APICloud 官方立即使用

概述

本模块封装了获取手机内置气压传感器数据的相关功能。可用手机直接获取当前所处环境的气压值。

气压计实际上叫测高仪,因为气压主要与海拔高度有关。气压计的硬件在手机内部,主要是检测大气压强(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 及更高版本