当前位置：首页 > news >正文

uniapp: 低功耗蓝牙（BLE）的使用

news 来源：原创 2025/6/9 9:44:32

在微信小程序中实现蓝牙对接蓝牙秤的重量功能，主要依赖微信小程序提供的低功耗蓝牙（BLE）API。以下是一个清晰的步骤指南，帮助你完成从连接蓝牙秤到获取重量数据的开发流程。需要注意的是，具体实现可能因蓝牙秤的协议和硬件特性而有所不同，因此你需要参考蓝牙秤的开发文档（比如服务UUID、特征值UUID等）。

开发步骤

1. 配置小程序权限

在小程序的 app.json 文件中添加蓝牙相关权限，确保小程序有权使用蓝牙功能：

jsonJSON 格式

{"permission": {"scope.bluetooth": {"desc": "您的蓝牙权限将用于连接蓝牙秤"}}
}

2. 初始化蓝牙适配器

使用 wx.openBluetoothAdapter 初始化蓝牙模块，确保手机蓝牙已开启：

javascriptJavaScript （英语）

wx.openBluetoothAdapter({success(res) {console.log('蓝牙适配器初始化成功');// 继续后续操作},fail(res) {console.log('蓝牙适配器初始化失败，请检查蓝牙是否开启', res);}
});

3. 搜索蓝牙设备

调用 wx.startBluetoothDevicesDiscovery 开始搜索附近的蓝牙设备。通常需要根据蓝牙秤的设备名称或服务UUID进行过滤：

javascriptJavaScript （英语）

wx.startBluetoothDevicesDiscovery({success(res) {console.log('开始搜索蓝牙设备');wx.onBluetoothDeviceFound((res) => {res.devices.forEach(device => {// 根据设备名称或服务UUID筛选蓝牙秤if (device.name.includes('YourScaleName')) { // 替换为实际蓝牙秤名称console.log('发现蓝牙秤:', device);// 停止搜索wx.stopBluetoothDevicesDiscovery();// 保存设备IDconst deviceId = device.deviceId;// 连接设备connectBLE(deviceId);}});});},fail(res) {console.log('搜索设备失败', res);}
});

4. 连接蓝牙秤

使用 wx.createBLEConnection 连接指定的蓝牙秤：

javascriptJavaScript （英语）

function connectBLE(deviceId) {wx.createBLEConnection({deviceId: deviceId,success(res) {console.log('连接蓝牙秤成功');// 获取服务getBLEDeviceServices(deviceId);},fail(res) {console.log('连接失败', res);}});
}

5. 获取服务和特征值

连接成功后，使用 wx.getBLEDeviceServices 和 wx.getBLEDeviceCharacteristics 获取蓝牙秤的服务和特征值。特征值中通常会有一个用于读取重量数据的特征（参考设备文档）：

javascriptJavaScript （英语）

function getBLEDeviceServices(deviceId) {wx.getBLEDeviceServices({deviceId: deviceId,success(res) {res.services.forEach(service => {// 假设目标服务UUID已知if (service.uuid === 'YOUR_SERVICE_UUID') { // 替换为实际服务UUIDgetBLEDeviceCharacteristics(deviceId, service.uuid);}});}});
}function getBLEDeviceCharacteristics(deviceId, serviceId) {wx.getBLEDeviceCharacteristics({deviceId: deviceId,serviceId: serviceId,success(res) {res.characteristics.forEach(characteristic => {// 找到支持通知（notify）的特征值，用于接收重量数据if (characteristic.properties.notify) {enableNotify(deviceId, serviceId, characteristic.uuid);}});}});
}

6. 启用通知并监听重量数据

使用 wx.notifyBLECharacteristicValueChange 启用特征值通知，并通过 wx.onBLECharacteristicValueChange 监听蓝牙秤发送的重量数据：

javascriptJavaScript （英语）

function enableNotify(deviceId, serviceId, characteristicId) {wx.notifyBLECharacteristicValueChange({deviceId: deviceId,serviceId: serviceId,characteristicId: characteristicId,state: true,success() {console.log('启用通知成功');// 监听特征值变化wx.onBLECharacteristicValueChange((res) => {const value = res.value; // ArrayBuffer类型数据const weight = parseWeightData(value); // 自定义解析函数console.log('当前重量:', weight);});}});
}// 解析重量数据（需根据蓝牙秤协议实现）
function parseWeightData(buffer) {const dataView = new DataView(buffer);// 示例：假设重量数据是2字节整数，单位为克const weightInGrams = dataView.getUint16(0, true); // 小端序return weightInGrams / 1000; // 转换为千克
}

7. 断开连接（可选）

使用完成后，可以通过 wx.closeBLEConnection 断开与蓝牙秤的连接：

javascriptJavaScript （英语）

wx.closeBLEConnection({deviceId: deviceId,success(res) {console.log('断开连接成功');}
});

注意事项

蓝牙秤协议：每款蓝牙秤的通信协议不同（如服务UUID、特征值UUID、数据格式），需仔细阅读设备提供的开发文档。
兼容性：iOS和Android在蓝牙实现上可能有细微差异，尤其是特征值UUID的处理（有时大小写敏感）。
数据解析：蓝牙秤返回的重量数据可能是二进制格式（如ArrayBuffer），需要根据协议转换为可读的重量值。
错误处理：确保在每个步骤中添加失败回调，提示用户检查蓝牙状态或设备连接。

流程总结

初始化蓝牙适配器。
搜索并连接目标蓝牙秤。
获取服务和特征值，找到重量数据的特征。
启用通知并监听实时重量数据。
根据协议解析数据并显示。

相关文章：