企业内部开发 客户端API WECOM-JSSDK 蓝牙 获取已发现的蓝牙设备
获取已发现的蓝牙设备
最后更新:2023/02/23
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取已发现的蓝牙设备
最后更新:2023/02/23

目录

  • ww.getBluetoothDevices([params])
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • ww.getBluetoothDevices([params])

    兼容性:企业微信

    功能描述

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

    ww.getBluetoothDevices()

    参数说明

    params: Object

    属性类型默认值必填说明最低版本
    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型默认值必填说明最低版本
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    devicesObject[]

    已发现的蓝牙设备列表

    属性类型默认值必填说明最低版本
    namestring

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

    deviceIdstring

    用于区分设备的 ID

    RSSInumber

    当前蓝牙设备的信号强度

    advertisDataArrayBuffer

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

    advertisServiceUUIDsstring[]

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

    localNamestring

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

    serviceDataArrayBuffer

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

    使用说明

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

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

    上一篇
    停止搜寻蓝牙外围设备
    下一篇
    监听寻找到新设备