uni-app蓝牙踩坑小记
之前接了个与硬件建立蓝牙通讯的项目，学到了一些 uni-app 蓝牙操作的知识，也踩了一些坑，特此记录一下防止忘记。
Step1 初始化蓝牙适配器
使用uni.openBluetoothAdapter()函数初始化蓝牙适配器，uni.getBluetoothAdapterState()函数获取蓝牙适配器状态。
// Step1 初始化蓝牙
function initBlue() {
return new Promise((resolve, reject) => {
uni.openBluetoothAdapter({
success(res) {
console.log('初始化蓝牙成功')
uni.getBluetoothAdapterState({
success(r) {
console.log('蓝牙状态', r.available)
if (r.available) {
resolve()
}
else {
uni.showToast({
title: '请开启蓝牙',
icon: 'error',
duration: 2000,
})
reject()
}
},
fail(err) {
uni.showToast({
title: '请开启蓝牙',
icon: 'error',
duration: 2000,
})
reject()
},
})
},
fail(err) {
console.log('初始化蓝牙失败')
console.error(err)
uni.showToast({
title: '请开启蓝牙',
icon: 'error',
duration: 2000,
})
reject()
},
})
})
}Step2 开始搜索附近的蓝牙设备
使用uni.startBluetoothDevicesDiscovery()函数启动搜索附近的蓝牙设备，uni.onBluetoothDeviceFound()函数定义搜索到新设备时的回调函数。
// Step2 开始搜寻附近设备
function discovery() {
return new Promise((resolve, reject) => {
uni.startBluetoothDevicesDiscovery({
success(res) {
uni.showLoading({
title: '正在搜索设备',
icon: 'none',
})
// 开启监听回调
uni.onBluetoothDeviceFound((devices) => {
let obj = devices.devices[0]
console.log(obj.name)
if (obj.name === conf.deviceName) {
// 找到目标设备
// 设置设备ID到同步缓存中
uni.setStorageSync('deviceId', obj.deviceId)
uni.hideLoading()
resolve()
}
})
console.log('搜索蓝牙外围设备完成', res)
},
fail(err) {
console.log(err)
},
})
})
}Step3 连接蓝牙设备
使用uni.createBLEConnection(deviceId)函数连接到目标蓝牙设备。
// Step3 连接设备
function connect() {
return new Promise((resolve, reject) => {
uni.createBLEConnection({
deviceId: uni.getStorageSync('deviceId'), // 设备id
success(res) {
console.log('连接成功')
console.log(res)
uni.showToast({
title: '连接成功',
icon: 'success',
})
// Step4 蓝牙连接成功后关闭蓝牙搜索
stopDiscovery()
resolve()
},
fail(err) {
uni.showToast({
title: '连接失败',
icon: 'error',
})
console.log('蓝牙连接失败')
console.log(err)
reject()
},
})
})
}重要
由于 Setp2 中搜索蓝牙设备的功能比较耗费系统资源，因此在搜索并连接到设备后务必停止搜索。
Step4 停止搜索
使用uni.stopBluetoothDevicesDiscovery()函数停止搜索附近的蓝牙设备。
// Step4 停止搜索
function stopDiscovery() {
uni.stopBluetoothDevicesDiscovery({
success(res) {
console.log('停止成功')
console.log(res)
},
fail(err) {
console.log('停止失败')
console.error(err)
},
})
}Step5 获取蓝牙设备所有服务
使用uni.getBLEDeviceServices(deviceId)函数获取蓝牙设备所有服务。
// Step5 获取蓝牙设备所有服务
function getServices() {
return new Promise((resolve, reject) => {
uni.getBLEDeviceServices({
deviceId: uni.getStorageSync('deviceId'),
success(res) {
console.log(res)
resolve()
},
fail(err) {
console.error(err)
reject()
},
})
})
}Step6 获取蓝牙设备某个服务中所有特征值
使用uni.getBLEDeviceCharacteristics(deviceId, serviceId)函数获取蓝牙设备某个服务中所有特征值。
// Step6 获取蓝牙设备某个服务中所有特征值
function getCharacteristics() {
return new Promise((resolve, reject) => {
uni.getBLEDeviceCharacteristics({
deviceId: uni.getStorageSync('deviceId'),
serviceId: conf.serviceId,
success(res) {
console.log(res)
resolve()
},
fail(err) {
console.error(err)
reject()
},
})
})
}Step7 开启消息监听
使用uni.notifyBLECharacteristicValueChange(deviceId, serviceId, characteristicId, ...)函数开启消息监听。
// Step7 开启消息监听
function notify(handleFunc) {
// 这里传入一个回调函数，用于处理接收到的数据。
uni.notifyBLECharacteristicValueChange({
deviceId: uni.getStorageSync('deviceId'), // 设备id
serviceId: conf.serviceId, // 监听指定的服务
characteristicId: conf.characteristicId, // 监听对应的特征值
state: true,
success(res) {
console.log(res)
listenValueChange(handleFunc) // 开启监听消息变化，并传入回调函数。
},
fail(err) {
console.error(err)
uni.showToast({
title: '监听失败',
icon: 'error',
})
},
})
}Step8 监听消息变化
使用uni.onBLECharacteristicValueChange()函数监听消息变化并根据需求做相应处理。
// Step8 监听消息变化
function listenValueChange(handleFunc) {
// 这里传入一个回调函数，用于处理接收到的数据。
uni.onBLECharacteristicValueChange((res) => {
let resArray = ab2array(res.value) // 拿到数字数组
// Something to do...
})
}
// ArrayBuffer 转数组
function ab2array(buffer) {
return Array.from(new Uint8Array(buffer))
}Step9 发送数据
使用uni.writeBLECharacteristicValue(deviceId, serviceId, characteristicId, value)函数向蓝牙设备发送数据。
// Step9 发送数据
function sendCommand(data) {
uni.writeBLECharacteristicValue({
deviceId: uni.getStorageSync('deviceId'),
serviceId: conf.serviceId,
characteristicId: conf.characteristicId,
// 注意：value 是ArrayBuffer类型，需要进行转换。
value: array2ab(data),
success(res) {
console.log(`写入成功${res.errMsg}`)
},
fail(err) {
console.error(err)
uni.showToast({
title: '指令发送失败',
icon: 'error',
})
},
})
}
// 数组转Arraybuffer
function array2ab(numbers) {
// 创建一个ArrayBuffer，其大小等于数字数组的长度
const buffer = new ArrayBuffer(numbers.length)
// 创建一个Uint8Array视图来操作buffer
const uint8View = new Uint8Array(buffer)
// 将数字填充到Uint8Array中
for (let i = 0; i < numbers.length; i++) {
uint8View[i] = numbers[i]
}
// 返回ArrayBuffer
return buffer
}Step10 断开蓝牙连接
使用uni.closeBLEConnection(deviceId)函数断开蓝牙连接。
// Step10 断开蓝牙连接
function stopConnection() {
return new Promise((resolve, reject) => {
uni.closeBLEConnection({
deviceId: uni.getStorageSync('deviceId'), // 设备id
success(r) {
resolve()
},
fail(r) {
console.log(r)
reject()
},
})
})
}踩过的坑
为什么收到的数据是乱码（不符合预期）？
- 协议文档写错了：可能是文档看错了或者硬件那边把协议改了却没有更新文档。
- 数据类型不对：可能是收到的数据没有进行转换，直接在 ArrayBuffer 上面进行了数据解析操作。
- 硬件波特率设置有问题：可能是硬件那边的波特率设置有问题，导致数据收发不正常。经过
测试踩坑，波特率设置成 9600 时， 数据收发正常。
