微信开发BLE小程序前期准备工作：
- 微信小程序蓝牙开发文档
- 微信开发工具 至于这个软件是nw.js写的 为什么不支持linux 我也不知道
- 需要的蓝牙设备 （此文将只针对BLE设备进行说明）
- 如果你是快应用的开发者，请自行脑补快应用api 如果我没观察错，大部分api都长一个样 快应用蓝牙文档
// 快应用这个例子 ‘FEE7’和微信的一毛一样，这个serviceuuid是微信硬件平台的蓝牙智能灯
bluetooth.startDevicesDiscovery({
services: ['FEE7'],
success: function() {
console.log('success')
}
})
微信蓝牙API
微信有操作蓝牙适配器的操作有4个。
// 初始化(打开)蓝牙适配器
wx.openBluetoothAdapter
// 关闭蓝牙模块
wx.closeBluetoothAdapter
// 获取本机蓝牙适配器状态
wx.getBluetoothAdapterState
// 监听蓝牙适配器状态变化事件
wx.onBluetoothAdapterStateChange
注： 打开蓝牙设备适配器不等于手机端蓝牙开关，此操作是基于微信层面打开微信的蓝牙开关，若系统蓝牙未打开 wx.closeBluetoothAdapter 会调用失败，<font color="red">若系统没有赋予微信蓝牙权限，部分机型无报错。</font>
扫描获取周围设备操作4个
// 开始搜寻附近的蓝牙外围设备
wx.startBluetoothDevicesDiscovery
// 停止搜寻附近的蓝牙外围设备
wx.stopBluetoothDevicesDiscovery
// 获取所有已发现的蓝牙设备
wx.getBluetoothDevices
// 监听寻找到新设备的事件
wx.onBluetoothDeviceFound
- wx.startBluetoothDevicesDiscovery 和 wx.onBluetoothDeviceFound 是配对使用，蓝牙设备通信api基本上都为订阅式的，与传统http通信有很大的不同。搜索蓝牙可以通过serviceuuid区分，包含数组中任意一个service都将被搜索到。
- 由于业务需求，需要格式化蓝牙广播消息和名称筛选,wx.getBluetoothDevices 此API获取的都是原始搜索数据，故不建议使用，自行维护一份格式化后的list。
- 在低版本IOS端微信上会出现重复的蓝牙设备，但是wx.startBluetoothDevicesDiscovery中已经声明了非重复上报
allowDuplicatesKey：false。
蓝牙连接操作2个
// 连接低功耗蓝牙设备
wx.createBLEConnection
// 断开与低功耗蓝牙设备的连接
wx.closeBLEConnection
- 蓝牙断开操作极其耗时，亲测设备断开经常长达10秒及以上，故不推荐使用，断开蓝牙建议使用 wx.closeBluetoothAdapter 直接关闭蓝牙模块，简单粗暴迅速，但是这样每次操作蓝牙设备都要先调用打开适配器。
读写BLE特征值操作8个
// 根据 uuid 获取处于已连接状态的设备
wx.getConnectedBluetoothDevices
// 获取蓝牙设备所有 service（服务）
wx.getBLEDeviceServices
// 获取蓝牙设备所有 characteristic（特征值）
wx.getBLEDeviceCharacteristics
// 读取低功耗蓝牙设备的特征值的二进制数据值
wx.readBLECharacteristicValue
// 向低功耗蓝牙设备特征值中写入二进制数据
wx.writeBLECharacteristicValue
// 启用低功耗蓝牙设备特征值变化时的 notify 功能
wx.notifyBLECharacteristicValueChange
// 监听低功耗蓝牙设备的特征值变化
wx.onBLECharacteristicValueChange
// 监听低功耗蓝牙连接的连接状态改变
wx.onBLEConnectionStateChange
蓝牙serviceuuid 一般用于区别不同的设备，基本上每个ID对应一个BLE蓝牙产品。
每一个serviceuuid又对应不同的
characteristic，这些characteristic通常包含read/write/write/indicate中的一种或多着属性（具体看蓝牙协议自定）
小程序内通过service 与 characteristic组合去监听或发送消息，
必须设备的特征支持 notify 或者 indicate 才可以成功调用监听，支持read才可以调用写入二进制数据。
蓝牙开发流程
搜索蓝牙设备
// part 1.
// 关闭蓝牙模块 防止之前还有蓝牙缓存 先关闭再打开，以防万一
wx.closeBluetoothAdapter({
// 接口调用结束的回调函数
success: function () {
// 初始化蓝牙模块
wx.openBluetoothAdapter({
success: function () {
// 获取本机蓝牙适配器状态 很少使用
// wx.getBluetoothAdapterState({
// success: function (res) {
// console.log(res)
// },
// })
// 开始搜寻附近的蓝牙外围设备
wx.startBluetoothDevicesDiscovery({
//不允许重复上报设备（低版本ios 有概率出现失效，表现为同设备不同RSSI信号强度）
allowDuplicatesKey: false,
// 搜索到蓝牙的上报频率，每120毫秒上报一次搜索到的设备
interval: 120,
// 业务需求，我司设备都包含这两个service，此处是包含任意一个就可以被搜到
services: ['0000FFC0', '0000FFF0'],
success: function () {
//do somthing... 一般式用于初始化一些属性
},
})
},
// 失败时调用弹窗告诉用户蓝牙尚未打开
fail: function () {
wx.showModal({
title: '提示',
content: '请检查手机蓝牙是否打开',
showCancel: false,
success: function () {
// do something
},
})
},
})
},
})
// part 2. 这部分属于重点，用于找到设备后的订阅操作
// 找到新的蓝牙设备
// 此处是接受一个obj包含120毫秒内找到的符合要求的设备
wx.onBluetoothDeviceFound(function (obj) {
// 这个list是未过滤的list
const list = []
// 过滤后可见的
const viewList=[]
// 对象中的 devices 对象才是真身
const {
devices
} = obj
for (let device of devices) {
// 获取设备类型 机密操作 在广播值中获取真实的mac地址 设备类型等等操作 用于兼容ios设备 此操作需要设备固件写入mac
const bleType = getType(device)
// 根据协议解析广播包
if (device.advertisData) {
// 根据不同的设备解析不同的协议
device.advertisData = formatterAdvertis(device.advertisData, bleType)
}
device.bleType = bleType
list.push(device)
// 过滤设备是否可见
if (deviceCanView(device)) {
viewList.push(device)
}
}
// 由于120毫秒setData调用一次在一些低端机型上过于卡顿这里做了一下间隔，由于前期数据量较小，也方便首页加载显示，所以第二次第五次也进行刷新，否则每1200毫秒刷刷新一次。
if (that.data.cnt % 10 == 0 || [2, 5].includes(that.data.cnt)) {
that.setData({
viewList: [...that.data.viewList,...viewList]
})
}
// 计数
that.data.cnt++
// 直接赋值不会出发页面数据变化 安心赋值非过滤数据
that.data.devicesList = [...that.data.devicesList, ...list]
})
// part 3.
// 监听蓝牙断开 重置一些属性
wx.onBLEConnectionStateChange(function (res) {
// 连接断开后操作
if (!res.connected) {
// dosomthing
Dialog.close()
wx.showToast({
title: '蓝牙已断开',
icon: 'success',
duration: 500,
})
}
})
连接蓝牙设备
// part 1. 连接上设备 并监听notify
// 设置MTU最大传输单元
// 怎么硕呢，这个东西是因为之前流控数据，数据过长所以需要设置一下，仅安卓有效，ios设备会自动协商
wx.setBLEMTU({
// 这个id 就是苹果设备的uuid 安卓设备的mac地址
deviceId: device.deviceId,
mtu: 160,
success: (res) => {
console.log("setBLEMTU success")
},
fail: (res) => {
console.log("setBLEMTU fail", res)
}
});
wx.getBLEDeviceServices({
// 这个id 就是苹果设备的uuid 安卓设备的mac地址
deviceId: device.deviceId,
success: function (serviceRes) {
// 每个设备都有一个或多个service 所以这里拿到的是一个list 大家按需求去过滤
const services = serviceRes.services.filter(item => item.uuid.startsWith('0000FFF0'))[0]
wx.getBLEDeviceCharacteristics({
deviceId: device.deviceId,
serviceId: services.uuid,
success: function (characterRes) {
// 特征值也是一样的，每个service都包含不同的特征值，拿到的也是个list
// 写入特征值 这个特征值用于向设备写入二进制数据
const characteristics = characterRes.characteristics.filter(item => item.uuid.startsWith('0000FFF1'))[0]
// notify特征值 这个特征值用于监听notify
const notifyCharacteristics = characterRes.characteristics.filter(item => item.uuid.startsWith('0000FFF4'))[0]
// 启动广播
wx.notifyBLECharacteristicValueChange({
state: true,
deviceId: device.deviceId,
serviceId: services.uuid,
characteristicId: notifyCharacteristics.uuid,
success: function (_) {
// dosomething...
},
fail: function (e) {
console.log('启用notify失败', e)
},
})
},
})
},
})
// part 2. 向设备写入二进制数据
wx.writeBLECharacteristicValue({
// 这个id 就是苹果设备的uuid 安卓设备的mac地址
deviceId: device.deviceId,
// 所需要的特征值
serviceId: services.uuid,
// 设备用于notify的特征值
characteristicId: characteristics.uuid,
// 二进制数据 Arraybuffer 一般都是封装好的二进制协议包
value: buffer,
success: function (res) {
if (toast) {
wx.showToast({
title: '发送成功',
icon: 'success',
duration: 500,
})
}
},
fail: function (res) {
wx.showToast({
title: '发送失败',
icon: 'error',
duration: 500,
})
},
complete: callBack
})
蓝牙搜索，连接，写入，监听的操作基本都在上述这些，还有一些比如read操作，由于实际开发并未涉及所以未列出。
补充一些基础知识
1.微信BLE蓝牙通信
2.低功耗蓝牙协议解读
3.JavaScript 之二进制家族
4.BLE蓝牙协议分析
