title: Taro.onBluetoothDeviceFound(callback)

sidebar_label: onBluetoothDeviceFound

监听寻找到新设备的事件

注意

  • 若在 Taro.onBluetoothDeviceFound 回调了某个设备，则此设备会添加到 Taro.getBluetoothDevices 接口获取到的数组中。
  • 安卓下部分机型需要有位置权限才能搜索到设备，需留意是否开启了位置权限

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

参考文档

类型

  1. (callback: Callback) => void

参数

参数 类型 说明
callback Callback 寻找到新设备的事件的回调函数

Callback

寻找到新设备的事件的回调函数

  1. (result: CallbackResult) => void
参数 类型
result CallbackResult

CallbackResult

参数 类型 说明
devices CallbackResultBlueToothDevice[] 新搜索到的设备列表

CallbackResultBlueToothDevice

新搜索到的设备

参数 类型 说明
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.onBluetoothDeviceFound(function (res) {
  12.   var devices = res.devices;
  13.   console.log('new device list has founded')
  14.   console.dir(devices)
  15.   console.log(ab2hex(devices[0].advertisData))
  16. })