ap.startBluetoothDevicesDiscovery 开始搜寻附近的蓝牙外围设备

优质

小牛编辑

133浏览

2023-12-01

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

开始搜寻附近的蓝牙外围设备。搜索结果将在 bluetoothDeviceFound 事件中返回。可直接传入一个数组作为 OPTION.services 参数。也可直接传入一个字符串作为 OPTION.services 的第一项。

OPTION 参数说明

名称	类型	必填	描述
services	Array	否	蓝牙设备主 service 的 uuid 列表
allowDuplicatesKey	Boolean	否	是否允许重复上报同一设备，如果允许重复上报，则onBluetoothDeviceFound 方法会多次上报同一设备，但是 RSSI 值会有不同
interval	Number	否	上报设备的间隔，单位为ms，默认为0ms，意思是找到新设备立即上报，否则根据传入的间隔上报

错误码说明

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');
  ap.onBluetoothDeviceFound(function(res){
    ap.showToast('搜索到' + res.devices.length + '个设备');
  });
  btn.addEventListener('click', function(){
    //此处 service 只是示例，并非真正的设备服务 id
    ap.startBluetoothDevicesDiscovery({
      services: ['0000fdd7-0000-1011-8004-00987f9b34fb']
    });
  });
</script>