Alipay JSSDK V3.1.1

ap.writeBLECharacteristicValue(OPTION, CALLBACK)

向低功耗蓝牙设备特征值中写入数据。

OPTION 参数说明

名称	类型	必填	描述
deviceId	String	是	蓝牙设备 id，参考 device 对象
serviceId	String	是	蓝牙特征值对应 service 的 uuid
characteristicId	String	是	蓝牙特征值的 uuid
descriptorId	String	否	notify 的 descriptor 的 uuid
value	Hex String	是	蓝牙设备特征值对应的值，16进制字符串,限制在20字节内。写入的二进制数据需要进行 hex 编码。

错误码说明

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.writeBLECharacteristicValue({
      // 这里的 deviceId 需要在上面的 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
      deviceId: 'deviceId',
      // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
      serviceId: 'serviceId',
      // 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
      characteristicId: 'characteristicId',
      // 这里的value是 16 进制字符串
      value: 'value',
      success: function(res){
        ap.alert('写入数据成功');
      },
      fail: function(res) {
        ap.showToast('写入数据失败');
      }
    });
  });
</script>

查看演示

扫码查看

用支付宝扫码运行

其他说明

设备的特征值必须支持 write 才可以成功调用，具体参照 characteristic 的 properties 属性。