微信小程序低功耗蓝牙
1.简述
蓝牙适配器接口是基础库版本 1.1.0 开始支持。
iOS 微信客户端 6.5.6 版本开始支持，Android 客户端暂不支持
蓝牙总共增加了18个api接口。
2.Api分类
搜索类
连接类
通信类
3.API的具体使用
详细见官网：
https://mp.weixin.qq.com/debug/wxadoc/dev/api/bluetooth.html#wxgetconnectedbluethoothdevicesobject
4. 案例实现
4.1 搜索蓝牙设备
/**
* 搜索设备界面
*/
Page({
data: {
logs: [],
list:[],
},
onLoad: function () {
console.log('onLoad')
var that = this;
// const SDKVersion = wx.getSystemInfoSync().SDKVersion || '1.0.0'
// const [MAJOR, MINOR, PATCH] = SDKVersion.split('.').map(Number)
// console.log(SDKVersion);
// console.log(MAJOR);
// console.log(MINOR);
// console.log(PATCH);
// const canIUse = apiName => {
// if (apiName === 'showModal.cancel') {
// return MAJOR >= 1 && MINOR >= 1
// }
// return true
// }
// wx.showModal({
// success: function(res) {
// if (canIUse('showModal.cancel')) {
// console.log(res.cancel)
// }
// }
// })
//获取适配器
wx.openBluetoothAdapter({
success: function(res){
// success
console.log("-----success----------");
console.log(res);
//开始搜索
wx.startBluetoothDevicesDiscovery({
services: [],
success: function(res){
// success
console.log("-----startBluetoothDevicesDiscovery--success----------");
console.log(res);
},
fail: function(res) {
// fail
console.log(res);
},
complete: function(res) {
// complete
console.log(res);
}
})
},
fail: function(res) {
console.log("-----fail----------");
// fail
console.log(res);
},
complete: function(res) {
// complete
console.log("-----complete----------");
console.log(res);
}
})
wx.getBluetoothDevices({
success: function(res){
// success
//{devices: Array[11], errMsg: "getBluetoothDevices:ok"}
console.log("getBluetoothDevices");
console.log(res);
that.setData({
list:res.devices
});
console.log(that.data.list);
},
fail: function(res) {
// fail
},
complete: function(res) {
// complete
}
})
},
onShow:function(){
},
//点击事件处理
bindViewTap: function(e) {
console.log(e.currentTarget.dataset.title);
console.log(e.currentTarget.dataset.name);
console.log(e.currentTarget.dataset.advertisData);
var title = e.currentTarget.dataset.title;
var name = e.currentTarget.dataset.name;
wx.redirectTo({
url: '../conn/conn?deviceId='+title+'&name='+name,
success: function(res){
// success
},
fail: function(res) {
// fail
},
complete: function(res) {
// complete
}
})
},
})
4.2连接 获取数据
/**
* 连接设备。获取数据
*/
Page({
data: {
motto: 'Hello World',
userInfo: {},
deviceId: '',
name: '',
serviceId: '',
services: [],
cd20: '',
cd01: '',
cd02: '',
cd03: '',
cd04: '',
characteristics20: null,
characteristics01: null,
characteristics02: null,
characteristics03: null,
characteristics04: null,
result,
},
onLoad: function (opt) {
var that = this;
console.log("onLoad");
console.log('deviceId=' + opt.deviceId);
console.log('name=' + opt.name);
that.setData({ deviceId: opt.deviceId });
/**
* 监听设备的连接状态
*/
wx.onBLEConnectionStateChanged(function (res) {
console.log(`device ${res.deviceId} state has changed, connected: ${res.connected}`)
})
/**
* 连接设备
*/
wx.createBLEConnection({
deviceId: that.data.deviceId,
success: function (res) {
// success
console.log(res);
/**
* 连接成功，后开始获取设备的服务列表
*/
wx.getBLEDeviceServices({
// 这里的 deviceId 需要在上面的 getBluetoothDevices中获取
deviceId: that.data.deviceId,
success: function (res) {
console.log('device services:', res.services)
that.setData({ services: res.services });
console.log('device services:', that.data.services[1].uuid);
that.setData({ serviceId: that.data.services[1].uuid });
console.log('--------------------------------------');
console.log('device设备的id:', that.data.deviceId);
console.log('device设备的服务id:', that.data.serviceId);
/**
* 延迟3秒，根据服务获取特征
*/
setTimeout(function () {
wx.getBLEDeviceCharacteristics({
// 这里的 deviceId 需要在上面的 getBluetoothDevices
deviceId: that.data.deviceId,
// 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
serviceId: that.data.serviceId,
success: function (res) {
console.log('000000000000' + that.data.serviceId);
console.log('device getBLEDeviceCharacteristics:', res.characteristics)
for (var i = 0; i < 5; i++) {
if (res.characteristics[i].uuid.indexOf("cd20") != -1) {
that.setData({
cd20: res.characteristics[i].uuid,
characteristics20: res.characteristics[i]
});
}
if (res.characteristics[i].uuid.indexOf("cd01") != -1) {
that.setData({
cd01: res.characteristics[i].uuid,
characteristics01: res.characteristics[i]
});
}
if (res.characteristics[i].uuid.indexOf("cd02") != -1) {
that.setData({
cd02: res.characteristics[i].uuid,
characteristics02: res.characteristics[i]
});
} if (res.characteristics[i].uuid.indexOf("cd03") != -1) {
that.setData({
cd03: res.characteristics[i].uuid,
characteristics03: res.characteristics[i]
});
}
if (res.characteristics[i].uuid.indexOf("cd04") != -1) {
that.setData({
cd04: res.characteristics[i].uuid,
characteristics04: res.characteristics[i]
});
}
}
console.log('cd01= ' + that.data.cd01 + 'cd02= ' + that.data.cd02 + 'cd03= ' + that.data.cd03 + 'cd04= ' + that.data.cd04 + 'cd20= ' + that.data.cd20);
/**
* 回调获取 设备发过来的数据
*/
wx.onBLECharacteristicValueChange(function (characteristic) {
console.log('characteristic value comed:', characteristic.value)
//{value: ArrayBuffer, deviceId: "D8:00:D2:4F:24:17", serviceId: "ba11f08c-5f14-0b0d-1080-007cbe238851-0x600000460240", characteristicId: "0000cd04-0000-1000-8000-00805f9b34fb-0x60800069fb80"}
/**
* 监听cd04cd04中的结果
*/
if (characteristic.characteristicId.indexOf("cd01") != -1) {
const result = characteristic.value;
const hex = that.buf2hex(result);
console.log(hex);
}
if (characteristic.characteristicId.indexOf("cd04") != -1) {
const result = characteristic.value;
const hex = that.buf2hex(result);
console.log(hex);
that.setData({ result: hex });
}
})
/**
* 顺序开发设备特征notifiy
*/
wx.notifyBLECharacteristicValueChanged({
deviceId: that.data.deviceId,
serviceId: that.data.serviceId,
characteristicId: that.data.cd01,
state: true,
success: function (res) {
// success
console.log('notifyBLECharacteristicValueChanged success', res);
},
fail: function (res) {
// fail
},
complete: function (res) {
// complete
}
})
wx.notifyBLECharacteristicValueChanged({
deviceId: that.data.deviceId,
serviceId: that.data.serviceId,
characteristicId: that.data.cd02,
state: true,
success: function (res) {
// success
console.log('notifyBLECharacteristicValueChanged success', res);
},
fail: function (res) {
// fail
},
complete: function (res) {
// complete
}
})
wx.notifyBLECharacteristicValueChanged({
deviceId: that.data.deviceId,
serviceId: that.data.serviceId,
characteristicId: that.data.cd03,
state: true,
success: function (res) {
// success
console.log('notifyBLECharacteristicValueChanged success', res);
},
fail: function (res) {
// fail
},
complete: function (res) {
// complete
}
})
wx.notifyBLECharacteristicValueChanged({
// 启用 notify 功能
// 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
deviceId: that.data.deviceId,
serviceId: that.data.serviceId,
characteristicId: that.data.cd04,
state: true,
success: function (res) {
console.log('notifyBLECharacteristicValueChanged success', res)
}
})
}, fail: function (res) {
console.log(res);
}
})
}
, 1500);
}
})
},
fail: function (res) {
// fail
},
complete: function (res) {
// complete
}
})
},
/**
* 发送 数据到设备中
*/
bindViewTap: function () {
var that = this;
var hex = 'AA5504B10000B5'
var typedArray = new Uint8Array(hex.match(/[\da-f]{2}/gi).map(function (h) {
return parseInt(h, 16)
}))
console.log(typedArray)
console.log([0xAA, 0x55, 0x04, 0xB1, 0x00, 0x00, 0xB5])
var buffer1 = typedArray.buffer
console.log(buffer1)
wx.writeBLECharacteristicValue({
deviceId: that.data.deviceId,
serviceId: that.data.serviceId,
characteristicId: that.data.cd20,
value: buffer1,
success: function (res) {
// success
console.log("success 指令发送成功");
console.log(res);
},
fail: function (res) {
// fail
console.log(res);
},
complete: function (res) {
// complete
}
})
},
/**
* ArrayBuffer 转换为 Hex
*/
buf2hex: function (buffer) { // buffer is an ArrayBuffer
return Array.prototype.map.call(new Uint8Array(buffer), x => ('00' + x.toString(16)).slice(-2)).join('');
}
})
5.效果展示
这里写图片描述
发送校验指令。获取结果
微信小程序蓝牙的API每个测试了一下发现跟以前的写Android的蓝牙调取是一样的，打开流程：先打开蓝牙的适配器，然后确定下本机的蓝牙状态，然后开始搜索蓝牙，搜索完成以后关闭搜索。开始连接，根据搜索到的mac 适配连接。在服务里监听连接断开的状态。Android 的可以看这里：蓝牙的使用。先看一下打印的log吧。
大概说明一下：打log 要这样写 console.log("初始化蓝牙适配器",res)，我一直都是 写成console.log("初始化蓝牙适配器"+res)。
搞的每次出不来。
流程是这样的：先初始化蓝牙适配器，然后获取本机蓝牙适配器的状态，然后开始搜索，当停止搜索以后在开始搜索，就会触发蓝牙是配置状态变化的事件，搜索完成以后获取所有已经发现的蓝牙设备，就可以将devices中的设备Array取出来了。然后就可以得到所有已经连接的设备了，至于链接功能，还没有真机可测，所以没有测试。
我的电脑上蓝牙连接的设备：
- // pages/bluetooth/bluetooth.js
- Page({
- data:{},
- onLoad:function(options){
- // 页面初始化 options为页面跳转所带来的参数
- },
- //初始化蓝牙适配器
- openBluetooth:function(){
- wx.openBluetoothAdapter({
- success: function(res){
- console.log(res.errMsg)
- // success
- wx.showToast({
- title:"初始化蓝牙适配器成功",
- duration:2000
- })
- },
- })
- },
- //关闭蓝牙模块
- closeBluetooth:function(){
- wx.openBluetoothAdapter()
- wx.closeBluetoothAdapter({
- success: function(res){
- // success
- console.log("success"+res)
- }
- })
- },
- //获取本机蓝牙适配器状态
- getBluetoothAdapterState:function(){
- wx.getBluetoothAdapterState({
- success: function(res){
- // success
- console.log("res:"+res)
- console.log("errMsg:"+res.errMsg)
- }
- })
- },
- //监听蓝牙适配器状态变化事件
- onBluetoothAdapterStateChange:function(){
- wx.onBluetoothAdapterStateChange(function(res) {
- console.log(`adapterState changed, now is`, res)
- })
- },
- // 开始搜寻附近的蓝牙外围设备
- startBluetoothDevicesDiscovery:function(){
- wx.startBluetoothDevicesDiscovery({
- success: function (res) {
- console.log(res)
- }
- })
- },
- // 停止搜寻附近的蓝牙外围设备
- stopBluetoothDevicesDiscovery:function(){
- wx.stopBluetoothDevicesDiscovery({
- success: function (res) {
- console.log(res)
- }
- })
- },
- //获取所有已发现的蓝牙设备
- getBluetoothDevices:function(){
- wx.getBluetoothDevices({
- success: function(res){
- // success
- console.log(res)
- },
- })
- },
- //监听寻找到新设备的事件
- onBluetoothDeviceFound:function(){
- wx.onBluetoothDeviceFound(function(res) {
- // callback
- console.log(res)
- })
- },
- //根据 uuid 获取处于已连接状态的设备
- getConnectedBluetoothDevices:function(){
- wx.getConnectedBluetoothDevices({
- success: function (res) {
- console.log(res)
- }
- })
- },
- //连接低功耗蓝牙设备
- createBLEConnection:function(){
- wx.createBLEConnection({
- deviceId: 'AC:BC:32:C1:47:80',
- success: function(res){
- // success
- console.log(res)
- },
- fail: function(res) {
- // fail
- },
- complete: function(res) {
- // complete
- }
- })
- },
- //断开与低功耗蓝牙设备的连接
- closeBLEConnection:function(){
- wx.closeBLEConnection({
- deviceId: 'AC:BC:32:C1:47:80',
- success: function (res) {
- console.log(res)
- }
- })
- },
- //监听低功耗蓝牙连接的错误事件，包括设备丢失，连接异常断开等等
- onBLEConnectionStateChanged:function(){
- wx.onBLEConnectionStateChanged(function(res) {
- console.log(`device ${res.deviceId} state has changed, connected: ${res.connected}`)
- })
- },
- //获取蓝牙设备所有 service（服务）
- getBLEDeviceServices:function(){
- wx.getBLEDeviceServices({
- deviceId: '48:3B:38:88:E3:83',
- success: function(res){
- // success
- console.log('device services:', res.services.serviceId)
- },
- fail: function(res) {
- // fail
- },
- complete: function(res) {
- // complete
- }
- })
- },
- //获取蓝牙设备所有 characteristic（特征值）
- getBLEDeviceCharacteristics:function(){
- wx.getBLEDeviceCharacteristics({
- deviceId: '48:3B:38:88:E3:83',
- serviceId: 'serviceId',
- success: function(res){
- // success
- },
- fail: function(res) {
- // fail
- },
- complete: function(res) {
- // complete
- }
- })
- }
- })