my.getBluetoothDevices

2020-09-15 15:20 更新

版本需求:支付宝客户端 10.0.18 或更高版本,若版本较低,建议做 兼容处理

注意:IDE 模拟器暂不支持调试,请以真机调试结果为准。

获取所有已发现的蓝牙设备,包括已经和本机处于连接状态的设备。

使用说明:

  • 模拟器可能无法获取 advertisData 及 RSSI,请使用真机调试。
  • 开发者工具(IDE)和 Android 上获取到的 deviceId 为设备 MAC 地址,iOS 上则为设备 UUID;因此 deviceId 不能硬编码到代码中,需要分平台处理,iOS 可根据设备属性( localName/advertisData/manufacturerData 等属性)进行动态匹配。

扫码体验

蓝牙.jpeg

效果示例

蓝牙通用.png

示例代码

my.getBluetoothDevices({
  success: (res) => {
    console.log(res)
  },
  fail:(res) => {
  },
  complete: (res)=>{
  }
});

入参

Object 类型,属性如下:

属性 类型 必填 描述
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

success 回调函数

入参为 Object 类型,属性如下:

属性 类型 描述
devices Array 已发现的设备列表

device 对象

属性 类型 描述
name String 蓝牙设备名称(某些设备可能没有)。
deviceName(兼容旧版本) String 值与 name 一致。
localName String 广播设备名称。
deviceId String 设备 ID。
RSSI Number 设备信号强度。
advertisData Hex String 设备的广播内容。
manufacturerData Hex String 设备的 manufacturerData。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号