服务商代开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
服务商代开发
客户端API
JS-SDK
蓝牙
获取已发现的蓝牙设备
获取已发现的蓝牙设备
最后更新:2025/03/21

目录

  • ww.getBluetoothDevices([params])
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • 旧版jweixin调用
  • 示例代码
  • ww.getBluetoothDevices([params])

    兼容性:企业微信

    功能描述

    获取在蓝牙模块生效期间所有已发现的蓝牙设备。

    ww.getBluetoothDevices()

    参数说明

    params: Object

    属性类型必填说明
    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    devicesObject[]

    已发现的蓝牙设备列表

    属性类型必填说明
    namestring

    蓝牙设备名称,某些设备可能没有

    deviceIdstring

    用于区分设备的 ID

    使用说明

    开发者工具和 Android 上获取到的 deviceId 为设备 MAC 地址,iOS 上为设备 uuid。因此 deviceId 不能硬编码到代码中

    RSSInumber

    当前蓝牙设备的信号强度

    使用说明

    Mac 系统可能无法获取 advertisData 及 RSSI,建议使用真机调试

    advertisDataArrayBuffer

    当前蓝牙设备的广播数据段中的 ManufacturerData 数据段

    使用说明

    • 注意 VConsole 无法打印出 ArrayBuffer 类型数据

    • Mac 系统可能无法获取 advertisData 及 RSSI,建议使用真机调试

    advertisServiceUUIDsstring[]

    当前蓝牙设备的广播数据段中的 ServiceUUIDs 数据段

    localNamestring

    当前蓝牙设备的广播数据段中的 LocalName 数据段

    serviceDataObject

    当前蓝牙设备的广播数据段中的 ServiceData 数据段

    使用说明

    • 该接口获取到的设备列表为蓝牙模块生效期间所有搜索到的蓝牙设备,若在蓝牙模块使用流程结束后未及时调用 closeBluetoothAdapter 释放资源,调用该接口可能会返回之前蓝牙使用流程中搜索到的蓝牙设备,可能设备已经不在用户身边,无法连接

    • 蓝牙设备在被搜索到时,系统返回的 name 字段一般为广播包中的 LocalName 字段中的设备名称,而如果与蓝牙设备建立连接,系统返回的 name 字段会改为从蓝牙设备上获取到的 GattName。若需要动态改变设备名称并展示,建议使用 localName 字段

    旧版jweixin调用

    示例代码

    // ArrayBuffer转16进制字符串示例
    function ab2hex(buffer) {
      var hexArr = Array.prototype.map.call(
        new Uint8Array(buffer),
        function(bit) {
          return ('00' + bit.toString(16)).slice(-2)
        }
      )
      return hexArr.join('');
    }
    wx.getBluetoothDevices({
      success: function (res) {
        console.log(res)
        if (res.devices[0]) {
          console.log(ab2hex(res.devices[0].advertisData))
        }
      }
    })
    上一篇停止搜寻蓝牙外围设备
    下一篇监听寻找到新设备
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们