微信小程序蓝牙开发详解

一、蓝牙技术简介

蓝牙技术是一种无线个人局域网技术，可用于连接移动电话、笔记本电脑、数字相机、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、在实际使用中，需要考虑蓝牙设备的能耗问题，尽量减少不必