Alipay JSSDK V3.1.1

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

根据 service 的 uuid 获取处于已连接状态的设备。可直接传入一个数组作为 OPTION.services 参数。也可直接传入一个字符串作为 OPTION.services 的第一项。

OPTION 参数说明

名称	类型	必填	描述
services	Array	否	蓝牙设备主 service 的 uuid 列表，如果services 为空，则返回所有的已经连接的设备

CALLBACK 参数说明

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

device对象说明

名称	类型	描述
name	String	蓝牙设备名称，某些设备可能没有
deviceName（兼容旧版本）	String	值与 name 一致
localName	String	广播设备名称
deviceId	String	设备 Id
RSSI	Number	设备信号强度
advertisData	Hex String	设备的广播内容

错误码说明

error	描述
12	获取失败

代码示例

<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');
  btn.addEventListener('click', function(){
    ap.getConnectedBluetoothDevices({
      success: function(res){
        ap.alert('共发现' + res.devices.length + '个设备');
      }
    });
  });
</script>

查看演示

扫码查看

用支付宝扫码运行

其他说明

Android 上获取到的 deviceId 为设备 MAC 地址，iOS 上则为设备 uuid。因此 deviceId 不能硬编码到代码中，需要区分处理。