一、蓝牙技术简介
蓝牙技术是一种无线个人局域网技术,可用于连接移动电话、笔记本电脑、数字相机、PDA等设备。它是一种开放的供应商中立技术,由Ericsson等公司在1994年创立,属于蓝牙专业小组SIG的一部分。
蓝牙技术最初旨在消除传统串行线缆的困扰,改用无线通信方式。蓝牙技术提供了简单的、安全的无线连接,其中包括数据和音频传输等多项服务,速度可达1Mbps,覆盖范围通常为10米。
蓝牙技术主要分为经典蓝牙和低功耗蓝牙两个版本,经典蓝牙适用于数据传输等场景,低功耗蓝牙适用于物联网等长期低功耗场景。
二、微信小程序蓝牙开发介绍
微信小程序提供了蓝牙API,可以通过小程序与蓝牙设备进行连接和数据交互。蓝牙功能的开发步骤一般包括以下几个方面:
1、初始化蓝牙适配器
wx.openBluetoothAdapter({
success: function (res) {
console.log('蓝牙适配器初始化成功')
},
fail: function (res) {
console.log('蓝牙适配器初始化失败')
}
})
2、搜索蓝牙设备
wx.startBluetoothDevicesDiscovery({
services: [], //搜索目标设备的服务
allowDuplicatesKey: false, //搜索结果是否允许重复
success: function (res) {
console.log('搜索蓝牙设备成功')
},
fail: function (res) {
console.log('搜索蓝牙设备失败')
}
})
3、监听蓝牙设备变化
wx.onBluetoothDeviceFound(function (devices) {
console.log('新设备', devices)
})
4、连接蓝牙设备
wx.createBLEConnection({
deviceId: '', //蓝牙设备ID
success: function (res) {
console.log('蓝牙设备连接成功')
},
fail: function (res) {
console.log('蓝牙设备连接失败')
}
})
5、监听蓝牙设备连接状态
wx.onBLEConnectionStateChange(function (res) {
console.log(`蓝牙设备 ${res.deviceId} 连接状态变化`, res.connected)
})
6、读写蓝牙设备数据
wx.readBLECharacteristicValue({
deviceId: '', //蓝牙设备ID
serviceId: '', //蓝牙设备服务ID
characteristicId: '', //蓝牙设备特征值ID
success: function (res) {
console.log('读取蓝牙设备数据成功', res)
},
fail: function (res) {
console.log('读取蓝牙设备数据失败', res)
}
})
wx.writeBLECharacteristicValue({
deviceId: '', //蓝牙设备ID
serviceId: '', //蓝牙设备服务ID
characteristicId: '', //蓝牙设备特征值ID
value: new ArrayBuffer(1), //写入的数据
success: function (res) {
console.log('写入蓝牙设备数据成功', res)
},
fail: function (res) {
console.log('写入蓝牙设备数据失败', res)
}
})
7、断开蓝牙设备连接
wx.closeBLEConnection({
deviceId: '', //蓝牙设备ID
success: function (res) {
console.log('蓝牙设备连接断开成功')
},
fail: function (res) {
console.log('蓝牙设备连接断开失败')
}
})
三、微信小程序蓝牙开发实战
通过蓝牙技术,我们可以让小程序连接到蓝牙设备,并将设备上的数据展示到小程序上。下面,我们以连接智能体脂秤为例,演示具体的代码实现过程。
1、初始化蓝牙适配器
wx.openBluetoothAdapter({
success: function (res) {
console.log('蓝牙适配器初始化成功')
//开启蓝牙搜索
wx.startBluetoothDevicesDiscovery({
services: [], //搜索目标设备的服务
allowDuplicatesKey: false, //搜索结果是否允许重复
success: function (res) {
console.log('搜索蓝牙设备成功')
},
fail: function (res) {
console.log('搜索蓝牙设备失败')
}
})
},
fail: function (res) {
console.log('蓝牙适配器初始化失败')
}
})
2、搜索蓝牙设备
在onBluetoothDeviceFound事件回调函数中,获取到设备后,根据设备名称进行判断,如果是智能体脂秤,则停止蓝牙搜索,并连接蓝牙设备。
//搜索到新设备
wx.onBluetoothDeviceFound(function (devices) {
console.log('新设备', devices)
//查找智能体脂秤设备
if (devices.name == 'Smart Body Scale') {
//停止搜索设备
wx.stopBluetoothDevicesDiscovery({
success: function (res) {
console.log('停止搜索蓝牙设备成功')
//连接蓝牙设备
wx.createBLEConnection({
deviceId: devices.deviceId,
success: function (res) {
console.log('蓝牙设备连接成功', res)
//监听连接状态变化
wx.onBLEConnectionStateChange(function (res) {
console.log(`蓝牙设备 ${res.deviceId} 连接状态变化`, res.connected)
})
//获取蓝牙设备服务列表
wx.getBLEDeviceServices({
deviceId: devices.deviceId,
success: function (res) {
console.log('获取蓝牙设备服务列表成功', res)
//获取第一个服务ID
var serviceId = res.services[0].uuid
//获取蓝牙设备特征值列表
wx.getBLEDeviceCharacteristics({
deviceId: devices.deviceId,
serviceId: serviceId,
success: function (res) {
console.log('获取蓝牙设备特征值列表成功', res)
//遍历特征值列表,找到读取数据的特征值ID和写入数据的特征值ID
for (var i = 0; i < res.characteristics.length; i++) {
var item = res.characteristics[i]
//读取数据的特征值
if (item.properties.read) {
that.setData({
readCharacteristicId: item.uuid
})
}
//写入数据的特征值
if (item.properties.write) {
that.setData({
writeCharacteristicId: item.uuid
})
}
}
//启用特征值的通知功能
wx.notifyBLECharacteristicValueChange({
deviceId: devices.deviceId,
serviceId: serviceId,
characteristicId: that.data.readCharacteristicId,
state: true,
success: function (res) {
console.log('启用特征值的通知功能成功', res)
//监听蓝牙设备数据变化
wx.onBLECharacteristicValueChange(function (res) {
console.log('蓝牙设备数据变化', res)
//处理蓝牙设备数据,并展示在小程序上
var data = new Uint8Array(res.value)
var weight = data[4] + (data[5] * 256) //体重
var fat = data[6] + (data[7] * 256) //体脂率
var water = data[8] + (data[9] * 256) //水分率
var muscle = data[10] + (data[11] * 256) //肌肉量
that.setData({
weight: weight / 100,
fat: fat / 100,
water: water / 100,
muscle: muscle / 100
})
})
},
fail: function (res) {
console.log('启用特征值的通知功能失败', res)
}
})
},
fail: function (res) {
console.log('获取蓝牙设备特征值列表失败', res)
}
})
},
fail: function (res) {
console.log('获取蓝牙设备服务列表失败', res)
}
})
},
fail: function (res) {
console.log('蓝牙设备连接失败', res)
}
})
},
fail: function (res) {
console.log('停止搜索蓝牙设备失败', res)
}
})
}
})
3、读取蓝牙设备数据
启用特征值的通知功能后,当设备上的数据发生变化时,会触发onBLECharacteristicValueChange事件回调函数,从而读取数据。
//监听蓝牙设备数据变化
wx.onBLECharacteristicValueChange(function (res) {
console.log('蓝牙设备数据变化', res)
//处理蓝牙设备数据,并展示在小程序上
var data = new Uint8Array(res.value)
var weight = data[4] + (data[5] * 256) //体重
var fat = data[6] + (data[7] * 256) //体脂率
var water = data[8] + (data[9] * 256) //水分率
var muscle = data[10] + (data[11] * 256) //肌肉量
that.setData({
weight: weight / 100,
fat: fat / 100,
water: water / 100,
muscle: muscle / 100
})
})
4、断开蓝牙设备连接
在小程序页面隐藏时,调用wx.closeBLEConnection方法断开蓝牙设备连接。
onHide: function () {
//断开蓝牙设备连接
wx.closeBLEConnection({
deviceId: this.data.deviceId,
success: function (res) {
console.log('蓝牙设备连接断开成功')
},
fail: function (res) {
console.log('蓝牙设备连接断开失败')
}
})
}
四、小结
通过蓝牙技术,可以让小程序连接到蓝牙设备,并进行数据读写。在实际开发中,需要注意以下几点:
1、对蓝牙设备进行操作时,需要先判断蓝牙是否可用,并且蓝牙设备是否已连接。
2、对于不同的蓝牙设备,需要了解其通信协议,并根据协议进行数据的解析和封装。
3、在实际使用中,需要考虑蓝牙设备的能耗问题,尽量减少不必