Alipay JSSDK V3.1.1

ap.getBLEDeviceCharacteristics(OPTION | deviceId, CALLBACK)

获取蓝牙设备所有 characteristic(特征值)。

OPTION 参数说明

名称类型必填描述
deviceIdString蓝牙设备 id,参考 device 对象
serviceIdString蓝牙特征值对应 service 的 uuid

CALLBACK 参数说明

名称类型描述
characteristicsArray设备特征值列表

characteristic 对象

蓝牙设备 characteristic (特征值)信息

名称类型描述
characteristicIdString蓝牙设备特征值的 uuid
serviceIdString蓝牙设备特征值对应服务的 uuid
valueHex String蓝牙设备特征值对应的16进制值
propertiesObject该特征值支持的操作类型

properties 对象

名称类型描述
readboolean该特征值是否支持 read 操作
writeboolean该特征值是否支持 write 操作
notifyboolean该特征值是否支持 notify 操作
indicateboolean该特征值是否支持 indicate 操作

错误码说明

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.getBLEDeviceCharacteristics({
      // 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
      deviceId: 'deviceId',
      // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
      serviceId: 'serviceId',
      success: function(res){
        ap.alert('此服务共有' + res.characteristics.length + '个特征值');
      },
      fail: function(res) {
        ap.showToast('获取失败');
      }
    });
  });
</script>

其他说明

  • 建立连接后先执行 my.getBLEDeviceServices 与 my.getBLEDeviceCharacteristics 后再进行与蓝牙设备的数据交互。