altimeter

来自于:APICloud 官方立即使用

isSupported startRelativeAltitudeUpdates stopRelativeAltitudeUpdates

概述

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

气压计实际上叫测高仪,因为气压主要与海拔高度有关。气压计的硬件在手机内部,主要是检测大气压强(kPa)的,而大气压强由于海拔高度有关。气压计不是检测风速的,不要以为对着手机吹气,气压值就会变化。另外,传感器不属于隐私功能,不需要授权。

在 iOS 端,气压计是 iPhone6 开始加入的硬件,不支持 iPhone6 以前的机型。最低支持系统版本是:iOS 8.0 在 android 端 需要根据isSupported方法返回的布尔类型来判断手机是否可以使用,true为可用,false为不可用

isSupported

判断当前设备是否支持气压计

isSupported(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: //布尔类型;是否支持,true|false
  3. }

示例代码

  1. var altimeter = api.require('altimeter');
  2. altimeter.isSupported(function(ret) {
  3. if (ret.status) {
  4. alert('支持');
  5. }
  6. });

可用性

iOS 系统,android 系统

可提供的 1.0.0 及更高版本

startRelativeAltitudeUpdates

开始获取海拔、气压值

startRelativeAltitudeUpdates(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:, //布尔类型;是否获取成功
  3. altitude:, //数字类型;开始获取气压时到本次获取之间的海拔高度差,单位 m
  4. pressure: //数字类型;气压值,单位 kPa
  5. }

示例代码

  1. var altimeter = api.require('altimeter');
  2. altimeter.startRelativeAltitudeUpdates(function(ret) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS 系统,android 系统

可提供的 1.0.0 及更高版本

stopRelativeAltitudeUpdates

停止获取气压

stopRelativeAltitudeUpdates()

示例代码

  1. var altimeter = api.require('altimeter');
  2. altimeter.stopRelativeAltitudeUpdates();

可用性

iOS 系统,android 系统

可提供的 1.0.0 及更高版本