序:最近做小程序,要用到蓝牙模块的,不知道如何下手,没关系,看文档,看案例!
看文档: 微信文档
看案例: 谷歌/百度/知乎等等,只要你觉得合适,都可以去尝试!
一、小程序 BLE 开发 API 简介
操作蓝牙适配器的共有 4 个:
wx.openBluetoothAdapter 初始化蓝牙适配器 1
wx.closeBluetoothAdapter 关闭蓝牙模块 2
wx.getBluetoothAdapterState 获取本机蓝牙适配器状态 3
wx.onBluetoothAdapterStateChange 监听蓝牙适配器状态变化事件 4扫描和获取周围 BLE 设备的有4个(操作方式与普通蓝牙一样):
wx.startBluetoothDevicesDiscovery 开始搜寻附近的蓝牙外围设备 5
wx.stopBluetoothDevicesDiscovery 停止搜寻附近的蓝牙外围设备 6
wx.getBluetoothDevices 获取所有已发现的蓝牙设备 7
wx.onBluetoothDeviceFound 监听寻找到新设备的事件 8连接BLE设备的2个:
wx.createBLEConnection 连接低功耗蓝牙设备 9
wx.closeBLEConnection 断开与低功耗蓝牙设备的连接 10连接成功后,读写BLE对应特征对象的数据:
wx.getConnectedBluetoothDevices 根据 uuid 获取处于已连接状态的设备 11
wx.getBLEDeviceServices 获取蓝牙设备所有 service(服务) 12
wx.getBLEDeviceCharacteristics 获取蓝牙设备所有 characteristic(特征值)13
wx.readBLECharacteristicValue 读取低功耗蓝牙设备的特征值的二进制数据值 14
wx.writeBLECharacteristicValue 向低功耗蓝牙设备特征值中写入二进制数据 15
wx.notifyBLECharacteristicValueChange 启用低功耗蓝牙设备特征值变化时的 notify 功能 16
wx.onBLECharacteristicValueChange 监听低功耗蓝牙设备的特征值变化 17
wx.onBLEConnectionStateChange 监听低功耗蓝牙连接的错误事件 18二、小程序蓝牙连接流程
我的连接流程是这样的(代码我就不多贴了,只要你有思路、有想法,你就是黑马):
初始化蓝牙设备之前,我做了一些的骚操作(不懂的查一下):
1、打开定位
/** 获取定位信息 */
getLocation: function () {
let that = this;
// 获取用户的当前设置。返回值中只会出现小程序已经向用户请求过的权限
wx.getSetting({
success: function (res) {
if(res.authSetting['scope.userLocation'] != undefined && res.authSetting['scope.userLocation'] != true){
wx.showModal({
title: '是否授权当前位置',
content: '需要获取你的地理位置,请确认授权,否则无法获蓝牙',
success: function(mres){
if(mres.confirm){
wx.openSetting({
success (authData) {
if(authData.authSetting['scope.userLocation'] == true){
wx.showToast({
title: '授权成功',
icon: "success",
duration: 1000
})
}else{
wx.showToast({
title: '授权失败',
icon: "error",
duration: 1000
})
}
}
})
}else if(mres.cancel){
wx.showToast({
title: '授权失败',
icon: "error",
duration: 1000
})
}
}
})
}else{
// 当前位置 wgs84 返回 gps 坐标,gcj02 返回可用于 wx.openLocation 的坐标
wx.getLocation({
type: 'wgs84',
success: function (res) {
console.log('打开地理位置')
},
})
}
},
})
},2、这个放到一个初始化方法里面,,校验一下微信的蓝牙权限是否打开:
init(){
let that = this;
// 可以通过 wx.getSetting 先查询一下用户是否授权了 "scope.bluetooth" 这个 scope
wx.getSetting({
success(res) {
// (1) 微信授权已关闭,弹窗打开
if (res.authSetting['scope.bluetooth'] != undefined && res.authSetting['scope.bluetooth'] == false) {
wx.openSetting({
success (authData) {
if(authData.authSetting['scope.bluetooth'] == true){
wx.showToast({
title: '授权成功',
icon: "success",
duration: 1000
})
that.openBluetoothAdapter(); // 打开蓝牙适配器
}else{
wx.showToast({
title: '授权失败',
icon: "success",
duration: 1000
})
}
}
})
}
// (2) 'scope.bluetooth'属性不存在,需要授权
if(res.authSetting['scope.bluetooth'] == undefined){
wx.authorize({
scope: 'scope.bluetooth',
success(res){
that.openBluetoothAdapter(); // 打开蓝牙适配器
}
})
}
// (3) 已经授权
if(res.authSetting['scope.bluetooth'] == true){
that.openBluetoothAdapter(); // 打开蓝牙适配器
}
}
})
}初始化蓝牙设备 1=》 (1_success)成功:开始搜索附近的蓝牙外围设备 5 , (1_fail)失败:获取蓝牙适配器状态 4;
=》1_success:发现蓝牙设备 8 (对结果进行过滤,符合条件的设备进行连接) =》 连接到目标设备 9 ,连接成功,监听蓝牙低功耗连接状态的改变事件 18,关闭蓝牙搜索 6 =》 获取蓝牙低功耗设备所有服务 12 =》 获取某个服务下所有的特征值 13 (打印一下特征值有:notify,read,write特征的),监听蓝牙低功耗设备的特征值变化 17 =》 启用低功耗蓝牙设备特征值变化时的 notify 功能 16 ;
=》1_fail:available 为true时,开始搜索附近的蓝牙外围设备 5,否则提示检查蓝牙是否打开
你会发现,有好几个是一些流程中没用到的,但是,这是不可能发生的,存在必有其道理;
(1)比如:你刷新时,你不可能再重新走一遍初始化蓝牙吧,那就要用到 获取蓝牙适配器状态 3 ,判断是 获取所有已发现的蓝牙设备 8 还是 开始搜索附近的蓝牙外围设备 5;
(2)比如:要你断开主动断开蓝牙连接,断开与低功耗蓝牙设备的连接 10;
(3)比如:短时间内,频繁退出或多次扫描 重新进入已连接蓝牙的小程序,在 onLoad 要用的 根据 uuid 获取处于已连接状态的设备 11(连接后,缓存 services 连接的 uuid 值),不然你已连接了设备,还一直搜不到;
(4)比如:关闭蓝牙模块 2,获取所有已发现的蓝牙设备 7,读取低功耗蓝牙设备的特征值的二进制数据值 14,向低功耗蓝牙设备特征值中写入二进制数据 15 ,这个几个不用我多说了吧。
三、总结:
iOS 的坑是比较少一些的,Android 机的确实有很多不完善的地方,毕竟是百花齐放的嘛
文章深入浅出,既有深度思考,又不乏广度覆盖,令人叹为观止。
?学术类评语?
?实用类评语?
这篇文章如同一幅色彩斑斓的画卷,每一笔都充满了独特的创意。
作者的情感表达细腻入微,让人在阅读中找到了心灵的慰藉。
这篇文章提供了宝贵的经验和见解,对读者有很大的启发和帮助。