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 及更高版本