Alipay JSSDK V3.1.1

ap.onBluetoothDeviceFound(CALLBACK)

搜索到新的蓝牙设备时触发此事件。

CALLBACK 参数说明

名称类型描述
devicesArray新搜索到的设备列表。device 对象说明见下表

device 对象说明

名称类型描述
deviceNameString蓝牙设备名称,某些设备可能没有
localNameString广播设备名称
deviceIdString设备 Id
RSSINumber设备信号强度
advertisDataHex String设备的广播内容

代码示例

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

<button id="J_btn" 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('0000fdd7-0000-1011-8004-00987f9b34fb');
  });
</script>

其他说明

  • 模拟器可能无法获取 advertisData 及 RSSI ,请使用真机调试。
  • 若在 ap.onBluetoothDeviceFound 回调中包含了某个蓝牙设备,则此设备会添加到 ap.getBluetoothDevices 接口获取到的数组中。