title: Taro.getBluetoothDevices(option)

sidebar_label: getBluetoothDevices

获取在蓝牙模块生效期间所有已发现的蓝牙设备。包括已经和本机处于连接状态的设备。

注意事项

  • 该接口获取到的设备列表为蓝牙模块生效期间所有搜索到的蓝牙设备，若在蓝牙模块使用流程结束后未及时调用 Taro.closeBluetoothAdapter 释放资源，会存在调用该接口会返回之前的蓝牙使用流程中搜索到的蓝牙设备，可能设备已经不在用户身边，无法连接。
  • 蓝牙设备在被搜索到时，系统返回的 name 字段一般为广播包中的 LocalName 字段中的设备名称，而如果与蓝牙设备建立连接，系统返回的 name 字段会改为从蓝牙设备上获取到的 GattName。若需要动态改变设备名称并展示，建议使用 localName 字段。

支持情况：getBluetoothDevices - 图1 getBluetoothDevices - 图2 getBluetoothDevices - 图3

参考文档

类型

  1. (option?: Option) => Promise<SuccessCallbackResult>

参数

参数 类型
option Option

Option

参数 类型 必填 说明
complete (res: TaroGeneral.BluetoothError) => void 否 接口调用结束的回调函数（调用成功、失败都会执行）
fail (res: TaroGeneral.BluetoothError) => void 否 接口调用失败的回调函数
success (res: SuccessCallbackResult) => void 否 接口调用成功的回调函数

SuccessCallbackResult

参数 类型 说明
devices SuccessCallbackResultBlueToothDevice[] uuid 对应的的已连接设备列表
errMsg string 成功：ok，错误：详细信息

SuccessCallbackResultBlueToothDevice

uuid 对应的的已连接设备列表

参数 类型 说明
RSSI number 当前蓝牙设备的信号强度
advertisData ArrayBuffer 当前蓝牙设备的广播数据段中的 ManufacturerData 数据段。
advertisServiceUUIDs string[] 当前蓝牙设备的广播数据段中的 ServiceUUIDs 数据段
deviceId string 用于区分设备的 id
localName string 当前蓝牙设备的广播数据段中的 LocalName 数据段
name string 蓝牙设备名称，某些设备可能没有
serviceData TaroGeneral.IAnyObject 当前蓝牙设备的广播数据段中的 ServiceData 数据段

示例代码

  1. // ArrayBuffer转16进度字符串示例
  2. function ab2hex(buffer) {
  3.   var hexArr = Array.prototype.map.call(
  4.     new Uint8Array(buffer),
  5.     function(bit) {
  6.       return ('00' + bit.toString(16)).slice(-2)
  7.     }
  8.   )
  9.   return hexArr.join('');
  10. }
  11. Taro.getBluetoothDevices({
  12.   success: function (res) {
  13.     console.log(res)
  14.     if (res.devices[0]) {
  15.       console.log(ab2hex(res.devices[0].advertisData))
  16.     }
  17.   }
  18. })