blesdk

来自于：开发者立即使用

startScan stopScan setIgnored setAutoContinue

概述

blesdk模块功能

blesdk用于扫描手机周围蓝牙设备,当扫描到我公司蓝牙卡设备时,返回蓝牙卡卡号和蓝牙卡电量状态

要求 Android API 19及以上

使用说明

1.初始化

bleScanner = api.require('bleScanner');

2.开始扫描

  bleScanner.startScan(function(ret, err) {
      if (ret != "") {
        //在这里处理接收到的卡号与电量状态
    }
    if (err != "") {
        //无法开启扫描,在这里处理错误
    }
    });

3.结束扫描

bleScanner.stopScan();

模块接口

startScan

开始扫描周围的蓝牙设备,并返回扫描到的设备卡号

startScan(callback(ret,err))

callback(ret, err)

回调操作

ret：

  • 类型：JSON对象
  • 内部字段：
    {
  card: ABCDE12345,   //string,蓝牙设备的十位卡号
  powerLow: false,    //bool型,true表示当前设备电量低
}

err：

  • 类型：JSON对象
  • 内部字段：
    {
  error: "ble scan is already started"     //string, error message
}

示例代码

bleScanner.startScan(function(ret, err) {
    if (ret != "") {
        addResult(JSON.stringify(ret));
    }
    if (err != "") {
        addResult(JSON.stringify(err));
    }
});

stopScan

停止扫描

stopScan()

示例代码

  bleScanner.stopScan();

setIgnored

忽略扫描结果,设为true后将忽略接下来的扫描结果,直到设为false 因为频繁开关BleScan,系统会抛出异常导致扫描开启失败,所以在频繁开关的场景建议使用该函数

setIgnored(param)

param

ignored：

  • 类型：布尔型
  • 描述：（可选项）是否忽略接下来的扫描结果
  • 默认值：false

示例代码

bleScanner.setIgnored({
        ignored:true
    });

setAutoContinue

设为false:用户设备(手机)的蓝牙关闭时,将自动停止扫描,在蓝牙重新打开后,不进行任何操作 设为true:用户设备(手机)的蓝牙关闭时,将自动停止扫描,并在蓝牙重新打开后,重新开始扫描

setAutoContinue(param)

param

autoContinue：

  • 类型：布尔型
  • 描述：（可选项）是否在蓝牙重开时重新扫描
  • 默认值：false

示例代码

bleScanner.setAutoContinue({
        autoContinue: true
});