ap.getBluetoothDevices 获取所有已发现的蓝牙设备

优质
小牛编辑
125浏览
2023-12-01

ap.getBluetoothDevices(OPTION | services | service, CALLBACK)

获取所有已发现的蓝牙设备,包括已经和本机处于连接状态的设备。可直接传入一个数组作为 OPTION.services 参数。也可直接传入一个字符串作为 OPTION.services 的第一项。

OPTION 参数说明

名称类型必填描述
servicesArray蓝牙设备主 service 的 uuid 列表

CALLBACK 参数说明

名称类型描述
devicesArrayservice 的 uuid 对应的(如果有传入 services)设备列表

device对象说明

名称类型描述
nameString蓝牙设备名称,某些设备可能没有
deviceName(兼容旧版本)String值与 name 一致
localNameString广播设备名称
deviceIdString设备 Id
RSSINumber设备信号强度
advertisDataHex String设备的广播内容

错误码说明

error描述
12获取失败

代码示例

<script src="https://gw.alipayobjects.com/as/g/h5-lib/alipayjsapi/3.1.1/alipayjsapi.inc.min.js"></script>

<button class="btn btn-default">获取已发现的蓝牙设备</button>
<script>
  var btn = document.querySelector('#J_btn');
  btn.addEventListener('click', function(){
    ap.getBluetoothDevices({
      success: function(res){
        ap.alert('共发现' + res.devices.length + '个设备');
      }
    });
  });
</script>