blesdk

概述

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
});
是否仍需要帮助? 请保持联络!
最后更新于 2024/12/2