您的位置:

微信小程序蓝牙开发详解

一、蓝牙技术简介

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