小工具知识网

当前位置: 首页 > 行业知识 > 小程序蓝牙连接ESP32通信(可直接拿来用)

行业知识

小程序蓝牙连接ESP32通信(可直接拿来用)

2026-11-05 13:54:09 来源:互联网转载

小程序中的蓝牙能力

在小程序中,要使用蓝牙能力(Beacon 除外)必须首先调用 wx.openBluetoothAdapter 初始化蓝牙适配器模块,其生效周期为调用 wx.openBluetoothAdapter 至调用 wx.closeBluetoothAdapter 或小程序被销毁为止。只有在小程序蓝牙适配器模块生效期间,开发者才能够正常调用蓝牙相关的小程序 API,并收到蓝牙模块相关的事件回调(绑定监听不受此限制)。

小程序对蓝牙支持情况如下:

经典蓝牙:iOS 因系统限制暂无法提供,安卓目前已在规划中。

蓝牙低功耗 (BLE):

  • 主机模式:基础库 1.1.0(微信客户端 iOS 6.5.6,Android 6.5.7)开始支持。
  • 从机模式:基础库 2.10.3 开始支持。
  • 蓝牙信标 (Beacon):基础库 1.2.0 开始支持。

    前置条件

    • 蓝牙模块需要是 低功耗蓝牙(BLE) ,不然小程序搜索不到(将导致无法继续进行开发),可购买我们的设备 来进行开发。
    • 开发者工具上只能模拟部分蓝牙接口能力,完整功能请使用真机调试。

      官方文档

      微信小程序蓝牙开发文档

      微信小程序提供的操作蓝牙的 API

      微信小程序目前有蓝牙 API 共 18 个

      操作蓝牙适配器的 API
      wx.openBluetoothAdapter 初始化蓝牙适配器wx.closeBluetoothAdapter 关闭蓝牙模块wx.getBluetoothAdapterState 获取本机蓝牙适配器状态wx.onBluetoothAdapterStateChange 监听蓝牙适配器状态变化事件
      连接前使用的 API
      wx.startBluetoothDevicesDiscovery 开始搜寻附近的蓝牙外围设备wx.stopBluetoothDevicesDiscovery 停止搜寻附近的蓝牙外围设备wx.getBluetoothDevices 获取所有已发现的蓝牙设备wx.onBluetoothDeviceFound 监听寻找到新设备的事件
      连接和断开时使用的 API
      wx.createBLEConnection 连接低功耗蓝牙设备wx.closeBLEConnection 断开与低功耗蓝牙设备的连接
      连接成功后使用的 API
      wx.getConnectedBluetoothDevices 根据 uuid 获取处于已连接状态的设备wx.getBLEDeviceServices 获取蓝牙设备所有 service(服务)wx.getBLEDeviceCharacteristics  获取蓝牙设备所有 characteristic(特征值)wx.readBLECharacteristicValue  读取低功耗蓝牙设备的特征值的二进制数据值wx.writeBLECharacteristicValue 向低功耗蓝牙设备特征值中写入二进制数据wx.notifyBLECharacteristicValueChange  启用低功耗蓝牙设备特征值变化时的 notify 功能wx.onBLECharacteristicValueChange 监听低功耗蓝牙设备的特征值变化wx.onBLEConnectionStateChange 监听低功耗蓝牙连接的错误事件

      基本操作流程

      最基本的操作流程是:初始化蓝牙适配器 → 开始搜寻附近的蓝牙外围设备 → 监听寻找到新设备的事件 → 连接低功耗蓝牙设备 → 获取蓝牙设备所有 service 和 characteristic → 读取或写入低功耗蓝牙设备的特征值的二进制数据值。

      蓝牙组件代码

      由于我们 index 中代码量比较多,不利于维护,所以我们将蓝牙功能单独抽离成一个 component(组件),方便管理和复用。

      新建一个 components 目录,在该目录下新建一个目录为 bluetooth-comp,然后在 bluetooth-comp 点击"新建 Component"按钮,输入 index 并点击确定。

      页面结构部分
        

上一篇:精灵帝国服务器怎么进入?

下一篇:网易服务器条款怎么写的?