关于 uniApp 中低功耗蓝牙的使用

原创

2024/6/13 20:00

uniApp

来龙去脉

上周四下午正在写着代码的时候，突然被领导拉倒一个群里，说一个安卓 app，在最新安卓版本 14 版本上适配的时候，不能使用，看看我们怎么能解决么，然后就我一个前端，就问我能做一个 app 么，我安卓蓝牙这方面没有做过，就说不是很舒服这方便，页面的话好实现，功能方便就不好说了，然后总经理就问我们项目经理，能实现么，大约需要多长时间，项目经理就说两三天吧，WTF??? 直接给我上强度，3 天时间让我实现这个 app 功能，一个软件从 0-1，还打包发版，怎么办，赶紧研究一下试试吧。

开搞

新建一个 uniapp 项目
申请一个安卓证书，打包时会使用安卓证书别名、证书私钥密码、证书文件，都需要在本地保存好。安卓证书说明，
然后尝试云打包，打包成功后，会有一个下载地址，为临时地址，只能下载 5 次
手机端安装，测试能否使用

尝试 1

INFO

使用的 dcloud 插件市场d 插件 -> 自定义低功耗蓝牙 API 原生插件

自定义低功耗蓝牙API原生插件官方提供图片

可以扫描到蓝牙，但是连接到蓝牙设备过几秒，会自动断开连接，尝试测试了好次，修改代码就是找不到原因无奈只能放弃，尝试 uniapp 官方的蓝牙 API

尝试 2

INFO

使用 uniapp uni-app 蓝牙 API 进行设备的调试

流程代码

初始化蓝牙 uni.openBluetoothAdapter(OBJECT)

uni.openBluetoothAdapter({
  success(res) {
    console.log(res)
    console.log('初始化蓝牙成功:' + e.errMsg);
  }
})

监听蓝牙链接状态

uni.onBLEConnectionStateChange((res) => {
  console.log(`设备的id： ${res.deviceId} , 连接状态: ${res.connected}`)
})

获取在蓝牙模块生效期间所有已发现的蓝牙设备。包括已经和本机处于连接状态的设备。 uni.getBluetoothDevices(OBJECT)

uni.getBluetoothDevices({
  success(res) {
    console.log('获取蓝牙列表', res.devices)
  }
})

监听寻找到新设备的事件 uni.onBluetoothDeviceFound(CALLBACK)

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) {
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) {
      return ('00' + bit.toString(16)).slice(-2)
    }
  )
  return hexArr.join('')
}

// 监听事件
* 如果遇到在vue2中遇到this指向的问题，建议将function改为箭头函数
uni.onBluetoothDeviceFound(function (res) {
  console.log('监听寻找到新设备的事件', res.devices)
  //可以将检测到的设备添加到列表中
})

// 下面为扫描到点的蓝牙 数据信息 services 为蓝牙的mac地址
[
  {
    "deviceId": "30:1B:97:B8:4D:38",
    "name": "865186059015801",
    "RSSI": -32,
    "localName": "865186059015801",
    "advertisServiceUUIDs": []
  }
]

连接低功耗蓝牙设备 uni.createBLEConnection(OBJECT)

uni.createBLEConnection({
  deviceId: '30:1B:97:B8:4D:38',
  success(res) {
    console.log('连接成功', res)
  }
})

获取蓝牙设备所有服务(service) uni.getBLEDeviceServices(OBJECT)

uni.getBLEDeviceServices({
  deviceId: '30:1B:97:B8:4D:38',
  success(res) {
    console.log('获取蓝牙设备所有服务(service)', res)
  }
})

获取蓝牙设备某个服务中所有特征值(characteristic) uni.getBLEDeviceCharacteristics

uni.getBLEDeviceCharacteristics({
  deviceId: '30:1B:97:B8:4D:38',
  serviceId: '0001800-0000-1000-8000-00805f9b34fb',
  success(res) {
    console.log('获取蓝牙设备某个服务中所有特征值(characteristic)', res)
  }
})

启用低功耗蓝牙设备特征值变化时的 notify 功能 uni.notifyBLECharacteristicValueChange(OBJECT)
- 注意：必须设备的特征值支持 notify 或者 indicate 才可以成功调用
- 必须先启用 notifyBLECharacteristicValueChange 才能监听到设备 characteristicValueChange 事件

uni.notifyBLECharacteristicValueChange({
  deviceId: '30:1B:97:B8:4D:38',
  serviceId: '0001800-0000-1000-8000-00805f9b34fb',
  characteristicId: '0002a29-0000-1000-8000-00805f9b34fb',
  state: true,
  success(res) {
    console.log('启用低功耗蓝牙设备特征值变化时的 notify 功能', res)
  }
})

监听低功耗蓝牙设备的特征值变化 uni.onBLECharacteristicValueChange(CALLBACK)

// ArrayBuffer转16进度字符串示例
function ab2hex(buffer) {
  const hexArr = Array.prototype.map.call(
    new Uint8Array(buffer),
    function (bit) {
      return ('00' + bit.toString(16)).slice(-2)
    }
  )
  return hexArr.join('')
}
//必须先启用 notifyBLECharacteristicValueChange 接口才能接收到设备推送的 notification
uni.onBLECharacteristicValueChange(function (res) {
  console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)
  console.log(ab2hex(res.value))
})

向低功耗蓝牙设备特征值中写入二进制数据 uni.writeBLECharacteristicValue(OBJECT)
- 在调用 notifyBLECharacteristicValueChange 成功后立即调用 writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误, 可以给 writeBLECharacteristicValue 添加一个 setTimeout 延迟写入

// 向蓝牙设备发送一个0x00的16进制数据
const hexStrings = ["68", "06", "AA", "01", "05", "A0", "0F", "00", "16"];
const intArray = hexStrings.map(str => parseInt(str, 16));
const buffer = new ArrayBuffer(intArray.length);
uni.writeBLECharacteristicValue({
  deviceId: '30:1B:97:B8:4D:38',
  serviceId: '0001800-0000-1000-8000-00805f9b34fb',
  characteristicId: '0002a29-0000-1000-8000-00805f9b34fb',
  value: buffer,
  success: (res) => {
    console.log('向低功耗蓝牙设备特征值中写入二进制数据 success', res)
  },
  fail: (err) => {
    console.log('写值报错', err)
  },
})

断开与低功耗蓝牙设备的连接 uni.closeBLEConnection(OBJECT)

uni.closeBLEConnection({
  deviceId: '30:1B:97:B8:4D:38',
  success(res) {
    console.log('断开连接成功', res)
  }
})

官方蓝牙API链接地址

官方低功耗蓝牙API链接地址

😊 😁

关于 uniApp 中低功耗蓝牙的使用 ​

​

开搞 ​

尝试 1 ​

尝试 2 ​

流程代码 ​

关于 uniApp 中低功耗蓝牙的使用

开搞

尝试 1

尝试 2

流程代码