引导
- 今天在这里记录分享一下低功耗蓝牙的使用方法和需要注意的地方
- 如果使用的微信小程序原生开发,使用方法是一样的,只需要把所有uni换成wx就行
- 例 wx.openBluetoothAdapter({})
- 文章中会详细写出每个api的注意事项和配套使用方法 供大家参考 希望可以帮到大家
1. 初始化蓝牙
- 使用之前一定要进行初始化，蓝牙初始化之后才可以进行下面一系列操作
- 就算使用的是低功耗蓝牙,也需要初始化
uni.openBluetoothAdapter({
// 蓝牙初始化成功执行
success:(res)=>{
// 这里成功之后就不用管了,直接执行就行
},
// 蓝牙初始化失败执行
fail:(err)=>{
// 初始化失败之后有需求的话可以进行一些处理
// 没有需求的也不用管
// 一般情况下,还是需要分析一下原因的,这用用户和自己就知道为什么失败了
if(err.errCode == 10001){
// 这种情况是未打开蓝牙 就需要提示用户检测蓝牙并打开
uni.showToast({
title: "请检查蓝牙是否开启!",
icon: "none",
duration: 2000,
});
}
// 我这里只演示这一个,其他的状态可进入官网进行查看
// uni-app https://uniapp.dcloud.io/api/system/bluetooth.html
// 微信原生 https://developers.weixin.qq.com/miniprogram/dev/api/device/bluetooth/wx.openBluetoothAdapter.html
}
})
2. 查找(搜寻)附近蓝牙
- 蓝牙初始化成功之后就可以进行查询附近蓝牙了
uni.startBluetoothDevicesDiscovery({
success:()=>{
// 调用成功之后就开始查询附近蓝牙了
// 成功之后可调用这个函数,每次查询到新的蓝牙设备就会调用
// 这个函数使用不使用都可以,不影响查询的结果
uni.onBluetoothDeviceFound((devices)=>{
console.log(devices) // 蓝牙设备信息
// 返回的数据是ArrayBuffer格式的需要进行转换,不然咱也看不懂都是些啥
// ArrayBuffer 的转换后面会详细写出来
})
// 接着进行 成功之后建议等个几秒钟之后再获取查询到的列表
// 我这里就是用定时器做了一个两秒的延迟
setTimeout(()=>{
uni.getBluetoothDevices({
success:(res)=>{
// res.devices 为 查询到的蓝牙设备列表
// 拿到结果之后,进行处理
// 首先进行过滤一下查询的列表,会出现很多未知设备这类的,这里就直接把它们给排除掉了,只留下有完整名称的设备
var arr = []
res.devices.forEach((element)=>{
if(element.name !== "位置设备") {
arr.push(element)
}
})
// 筛选之后在进行判断是否有正常的蓝牙设备
// 当然你也可以查看一下被筛选掉的设备是否有你所使用的设备,如果有你可以去掉筛选 或者自己定义筛选条件
if(arr.length == 0){
uni.showToast({
title: "未查询到可用设备,请重新扫描",
duration: 1000,
icon: "none",
});
}
// 最后这个arr就是所查到的列表
console.log(arr)
// 不管查没查到一定要使用 stopBluetoothDevicesDiscovery 停止查询
// 不管查没查到一定要使用 stopBluetoothDevicesDiscovery 停止查询
// 不管查没查到一定要使用 stopBluetoothDevicesDiscovery 停止查询
uni.stopBluetoothDevicesDiscovery()
}
})
},2000)
}
})
3. 连接蓝牙
- 现在蓝牙设备列表也有了,往下做的就是连接蓝牙
// 为了能否顺利的连接蓝牙 可以先查询一下是否有设备已经连接蓝牙了
// 手环这一类的设备 可能会对程序造成干扰 会一直显示设备已经连接
uni.getConnectedBluetoothDevices({
success:(res)=>{
// 因为我为了蓝牙的连接的稳定性,就做了这一步
// 大家使用的过程中可以省略这一步直接进行蓝牙设备
// 但是不确定是否可以正常进行蓝牙连接, 大家可以尝试一下
// 如果返回的列表不等于空,就代表已经有设备连接
if(res.devices.length !== 0) {
// 这里就需要提示用户蓝牙已连接
uni.showModal({
title: "提示!",
content: "当前蓝牙已于id为"+res.devices[0].deviceId+"的设备连接,是否断开连接",
success: (row)=>{
// 用户点击确定执行
if (row.confirm) {
// 用户点击确定之后把当前连接的蓝牙断开
uni.closeBLEConnection({
// 一定要传入当前连接蓝牙的deviceId
deviceId: deviceId,
success:()=>{
// 到这里就已经断开成功了,再次点击就可以进行连接了
uni.showToast({
title: "连接已断开!",
icon: "none",
duration: 2000,
});
},
fail:(err)=>{
// 走到这就是断开失败了,可以进行操作提示用户或者自己查看
uni.showToast({
title: err.errMsg,
icon: "none",
duration: 2000,
});
}
})
}else{
// 用户取消之后不需要做任何操作
console.log('用户点击了取消')
}
}
});
}else {
// 当前未处于已连接状态就开始进行连接,没有连接的情况下就可以直接连接蓝牙
uni.createBLEConnection({
// 连接的时候一定传入要连接蓝牙的deviceId
deviceId:deviceId,
// 这里可以选择设置一个延迟,如果延迟时间过了没有连接成功就直接提示报错
timeout:5000,
success:(res)=>{
// 连接成功之后可以再次进行查询一下当前连接的蓝牙信息,保存下载,后面方便使用
uni.getConnectedBluetoothDevices({
success:(devicess)=>{
// devicess就是当前已经连接的蓝牙列表
// 在这判断一下有没有蓝牙,如果有就证明确实已经连接成功
if(devicess.devices[0]){
// 到这里就可以提示用户成功,并且吧蓝牙信息保存下来方便后面使用
console.log(devicess.devices[0]) // 蓝牙信息
}else {
// 如果走这里面就是没有蓝牙设备,就要查看一下,看看是否真的连接成功了
}
}
})
},
fail:(err)=>{
// 在这里查看连接失败的信息,判断为什么连接失败
console.log(err)
}
})
}
}
})
4. 蓝牙通讯
- 至此以上操作蓝牙已经连接,但是还没有进行通讯
- 下面就是蓝牙的通讯
- 也可以说蓝牙能通讯了,才算是正在的连接成功
// 蓝牙接收数据主要使用的api是开启监听(uni.notifyBLECharacteristicValueChange)
// 但是开启监听是需要几个特殊的值才能开启
// 所以开启之前我们需要获取这个值
// deviceId 蓝牙deviceId,蓝牙信息中包含的有
// serviceId 蓝牙服务值,根据蓝牙deviceId获取
// characteristicId 蓝牙特征值 根据serviceId 获取
// 首先根据deviceId 获取到服务值 serviceId
uni.getBLEDeviceServices({
deviceId:deviceId, // 获取服务值,需要传入deviceId
success:(res)=>{
// res.services 返回一个数组,里面包含着支持不同的通讯方式的serviceId 一般为三个左右,也有可能更多
console.log(res.services)
// 拿到之后根据自己所需要的去保存serviceId,在后面使用
// 这里建议多试试,说不定那个可以用,又或者某个不能用
// 获取到之后就可以去拿着获取到的serviceId和deviceId去获取特征值
uni.getBLEDeviceCharacteristics({
deviceId:deviceId, // 传入获取到的deviceId
serviceId:serviceuuid, // 传入获取到的serviceuuid
success:(ress)=>{
// ress里面就是获取到的蓝牙特征值
// 注意:根据传入serviceuuid的不同获取到的特征值也是不一样的,
// 特征值分为,可读、可写、可通知等几个类型的，根据自己想要的操作选择特征值
console.log.(res.characteristics)
},
fial:(err)=>{
// 一般来说只要参数对,就不会报错
}
})
},
fial:(err)=>{
// 一般来说只要 deviceId 对,就不会报错
}
})
5. 启用 特征值 变化监听
- 什么是启用特征值变化监听,其实就是开启接收蓝牙设备发送过来的数据,你不启用就接收不到蓝牙数据
- 经上所诉,启用这个监听就变得重重之重,不启用,上面一系列操作白搭
- 启用特征值监听需要用到 deviceId、serviceuuid、characteristicId（特征值）
// 这里所声明介绍一下所用到的东西
// deviceId 就是上面蓝牙设备的deviceId
// serviceuuid 就是上面根据蓝牙设备获取到的serviceuuid
// characteristics 就是上面根据 deviceId 和 serviceuuid 获取到的
// characteristics 是一个数组里面包含着多个特征值, 根据使用去拿响应的特征值
// 我这里没有直接使用,而是进行一个循环判断,判断这么多的特征值中那个是符合要求的
var characteristicId;
var i = 0
then.characteristiclist.forEach((element) => {
if (element.properties.notify == true) {
if (i == 0) {
characteristicId = element.uuid;
i++;
}
}
});
// 为什么循环
// 因为开启uni.notifyBLECharacteristicValueChange需要特征值是需要固定的,我就直接判断写入了
uni.notifyBLECharacteristicValueChange({
deviceId: deviceId,
serviceId: serviceuuid,
characteristicId: characteristicId,
state: true,
success: () => {
console.log('监听启动成功');
// 启用成功之后就可以在uni.onBLECharacteristicValueChange 中获取到蓝牙设备发送的数据
},
});
6. 接收数据
- 到此整个蓝牙通讯就已经完成,接下来就是获取蓝牙发送的数据了
- 这里所用到的函数方法都会在最后一一列出
uni.onBLECharacteristicValueChange((res)=>{
console.log(res.value)
// 这就是蓝牙发送的数据 但是现在的数据,还不能直观的看出来是什么,还需要进行一些列转换才能直观查看
console.log(this.buf2str(res.value))
// 经过 this.buf2str 转换之后就可以直观查看 蓝牙返回的信息
})
7. 向设备写入数据
- 通讯当然不是单方面的通讯,我们也能向设备发送一些东西
- 下面就介绍一下想蓝牙发送数据
// 所用到的就是上面获取到的
// 但是特征值跟上面不一样,需要支持可写
var characteristicId;
var i = 0;
then.characteristiclist.forEach((element) => {
if (element.properties.write == true) {
if (i == 0) {
characteristicId = element.uuid;
i++;
}
}
});
uni.writeBLECharacteristicValue({
deviceId: deviceId,
serviceId: serviceuuid,
characteristicId: characteristicId,
value: this.string2buffer(row),
success: () => {
// console.log('指令写入成功');
// 写入成功之后在onBLECharacteristicValueChange里面应该是有反馈的
}
})
// this.string2buffer 把16进制字符串转换成buffer之后进行写入,我也忘了直接传入字符串可不可以使用,应该是不行,可以尝试一下,不行就按着我的来也行
8. 所用到的js函数
// 因为我所写入的指令带有一些特殊字符,我是手动转成16进制之后在进行的转换ArrayBufer
// 如果需要直接字符串转ArrayBufer,百度一下你就知道
// 将16进制字符串转换成ArrayBufer
string2buffer (str) {
return new Uint8Array(
str.match(/[\da-f]{2}/gi).map(function (h) {
return parseInt(h, 16);
})
).buffer;
}
// ArrayBufer 转字符串
buf2str (buffer) {
let encodedString = String.fromCodePoint.apply(
null,
new Uint8Array(buffer)
);
let decodedString = decodeURIComponent(escape(encodedString));
//没有这一步中文会乱码
return decodedString;
},
- 使用过程中 如遇到其它问题,尽可联系我
- 大家一起进步 一起改bug
- 纯手工制作,望多多支持
- 你的点赞就是我,制作的动力