sensor

来自于:开发者立即使用

概述

sensor模块封装了安卓手机获取传感器信息功能,使用此模块可实现对安卓手机所支持的单个或是全部传感器信息的获取。暂仅支持 android 平台。(5.0及以上版本)

getInfo

得到单个传感器信息

nfcGetId({params},callback(ret, err))

params

sensorType:

  • 类型:数字
  • 描述:(必填项)所需获取信息的传感器类型,由于官方模块SDK版本的限制,目前只开放出21个类型,并且由于里面有些信息对应android API版本要求21,所以需要android5.0及以上版本,后期官方SDK升级会相应的更新上去。
  • 类型说明:
           sensorType = 1  :加速度传感器
           sensorType = 2  :磁场传感器
           sensorType = 3  :方向传感器
           sensorType = 4  :陀螺仪传感器
           sensorType = 5  :光线传感器
           sensorType = 6  :压力传感器
           sensorType = 7  :温度传感器(老版本类型)
           sensorType = 8  :距离传感器
           sensorType = 9  :重力传感器
           sensorType = 10  :线性加速度传感器
           sensorType = 11  :旋转矢量传感器
           sensorType = 12  :相对湿度传感器
           sensorType = 13  :温度传感器(新版本类型)
           sensorType = 14  :未校准磁力传感器
           sensorType = 15  :未校准的旋转矢量传感器
           sensorType = 16  :未校准陀螺仪传感器
           sensorType = 17  :显着运动触发传感器
           sensorType = 18  :步进检测传感器
           sensorType = 19  :步进计数传感器
           sensorType = 20  :地磁旋转矢量传感器
           sensorType = 21  :心率监视传感器
           sensorType = 28  :6个自由度传感器
           sensorType = 29  :静止检测传感器
           sensorType = 30  :运动检测传感器
           sensorType = 31  :心跳传感器
           sensorType = 34  :低延迟体外检测传感器
           sensorType = 35  :未校准的加速度传感器
    

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    maximumRange:    //最大取值范围
    fifoMaxEventCount:    //最大事件处理数
    fifoReservedEventCount:    //最小事件处理数
    maxDelay:    //最大延迟时间
    minDelay:    //最小延迟时间
    reportingMode:    //报告模式
    name:    //设备名称
    power:    //功率
    resolution:    //精度
    type:    //传感器类型(int)
    stringType:    //传感器类型(string)
    ventor:    //设备供应商
    version:    //设备版本号
}

err:

  • 类型:JSON 对象

内部字段:

{
    msg:    //返回错误信息(该设备没有此传感器)
}

示例代码

var param = {sensorType: 1};
sensor.getInfo(param, function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("返回数据:" + "\n" +
            "最大取值范围:" + ret.maximumRange + "\n" +
            "最大事件处理数:" + ret.fifoMaxEventCount + "\n" +
            "最小事件处理数:" + ret.fifoReservedEventCount + "\n" +
            "最大延迟时间:" + ret.maxDelay + "\n" +
            "最小延迟时间:" + ret.minDelay + "\n" +
            "报告模式:" + ret.reportingMode + "\n" +
            "设备名称:" + ret.name + "\n" +
            "功率:" + ret.power + "\n" +
            "精度:" + ret.resolution + "\n" +
            "传感器类型(int):" + ret.type + "\n" +
            "传感器类型(string):" + ret.stringType + "\n" +
            "设备供应商:" + ret.ventor + "\n" +
            "设备版本号:" + ret.version);
    } else {
        console.log(JSON.stringify(err));
        alert(JSON.stringify(err.msg));
    }
});

补充说明

由于官方模块SDK 版本较低及要求的API版本太高,还有两个信息为开放出来,后期会相应的进行更新。

可用性

Android系统

可提供的1.0.0及更高版本

getInfos

得到所有安卓手机支持的传感器信息

getInfos(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    sensors:    //得到所有支持传感器信息(里面包含每个传感器的详细信息)
}

示例代码

var sensor= api.require('sensor');
sensor.getInfos(function (ret, err) {
    console.log(JSON.stringify(ret));
    alert("返回数据:" + "\n" + JSON.stringify(ret.sensors));
});

补充说明

得到的是安卓手机所支持的所以传感器信息。

可用性

Android系统

可提供的1.0.0及更高版本