小程序BLE踩坑记录

前往官方文档

项目描述

手机小程序通过BLE向android设备发送WIFI名称/密码等信息，设备收到后自动联网。

项目流程

设备首先添加自定义服务UUID和特征UUID。

用户预先连接WiFi、自动获取当前WiFi名称、用户填写当前WiFi密码、

初始化蓝牙、扫描BLE、获取扫描到的设备、点击连接BLE设备、获取该设备的所有服务UUID、

获取目标服务UUID的所有特征值、根据设备ID，特定服务UUID，特定特征值UUID写入数据。

写入数据特殊部分

• IOS：不需要分包发送，发送数据无限制，数据多传送时间削微变长。
• Android：单次最大发送20字节，所以需要分包发送，且需要自己实现。

踩坑记录

• 扫描

扫描成功后，不要立马调用停止扫描，不然在远程调试的时候一切正常，预览或者发布之后显示搜索到的结果列表长度为0。

• 获取扫描结果

该项目扫描场景是已进入页面自动扫描，测试时wx.getBluetoothDevices每次都是一进入时搜不到，点击重新扫描便可以立马搜索到。建议使用wx.onBluetoothDeviceFound获取扫描结果，但需要自行去重和过滤。扫描时间持续比较长，可以在点击连接时先用wx.stopBluetoothDevicesDiscovery停止扫描。

//去重及过滤
wx.onBluetoothDeviceFound(function (obj) {
  var temp = _this.data.scanDevices
  if (obj.devices[0].name) {
    obj.devices.map(dev => {
      let pDev = temp.find((it) => {
        return it.deviceId == dev.deviceId
      })
      if (!pDev) {
        temp.push(dev)
      }
    })
  }
  _this.setData({
    scanDevices: temp
  })
})

• 连接设备

遇到过连接一直操作超时，errCode10003，这里的原因很多，官方的讨论也很多，这里我重启了一次设备就好了，因此可能是设备问题，也可能是连接实例太多导致，最好发送完数据后用wx.closeBLEConnection关闭连接。

• 写数据

写数据是需要用到deviceId，serviceUUID，characteristicUUID，这三个值都必须通过Api获取，我试过不走Api，直接填入serviceUUID，characteristicUUID，结果写入失败。也可能是大小写和分隔符“-”的问题，不过最好是通过Api去拿值。还有，发送的数据需要转为ArrayBuffer格式。

//字符串转ArrayBuffer
char2buf(str) {
  var out = new ArrayBuffer(str.length)
  var u8a = new Uint8Array(out)
  var strs = str.split("")
  for (var i = 0; i < strs.length; i++) {
    u8a[i] = strs[i].charCodeAt()
  }
  return out
}

• 分包

整体思路为：

将发送的数据分为多条数据，保存到一个全局数组中，循环发送每一条数据，发送一条后在发送成功的回调中进行下一条数据发送，若其中一条失败，则从头重新开始。这里发送用的递归。特别注意的是，android每次发送后必须延时一段时间再发送下一条数据，不然会写入失败，推荐延时250ms。

一个包数据为20字节，但实际上单次可供发送的只有18字节，所以按照18去分包。

还需要对数据进行分割，这里每种数据使用||分割，使用#end作为结束标识符。设备监测到有此标识符则开始联网。

//递归
writeData: function (devId, serviceId, charaId) {
    var _this = this
    if (_this.data.sendNum >= _this.data.sendDataList.length) {
      wx.closeBLEConnection({
        deviceId: devId,
        success: function (res) {
          console.log(res)
        }
      })
      wx.hideLoading()
      wx.showToast({
        title: '发送成功',
        icon: 'success',
        duration: 2000
      })
      return
    }
    wx.writeBLECharacteristicValue({
      deviceId: devId,
      serviceId: serviceId,
      characteristicId: charaId,
      value: _this.data.sendDataList[_this.data.sendNum],
      success: function (res) {
        console.log('写入成功', res.errMsg)
        setTimeout(function () {
          _this.data.sendNum++
          console.log(_this.data.sendNum)
          _this.writeData(devId, serviceId, charaId)
        }, 250)
      },
      fail: function (res) {
        console.log(res)
        _this.setData({
          sendNum: 0
        })
      }
    })
  }

完整BLE代码

实际上#end和||分割存在bug，若数据中含有此类字符会导致设备端接收数据错误。此处不再深究。

项目地址