服务商代开发
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
服务商代开发
客户端API
WECOM-JSSDK
蓝牙(BLE)
写入BLE设备特征值数据
写入BLE设备特征值数据
最后更新:2023/02/23

目录

  • ww.writeBLECharacteristicValue(params)
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • ww.writeBLECharacteristicValue(params)

    兼容性:企业微信

    功能描述

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

    ww.writeBLECharacteristicValue({
      deviceId: deviceId,
      serviceId: serviceId,
      characteristicId: characteristicId,
      value: arrayBufferValue
    })

    参数说明

    params: Object

    属性类型默认值必填说明最低版本
    deviceIdstring

    蓝牙设备 ID

    需要已经通过 createBLEConnection 与对应设备建立链接

    serviceIdstring

    蓝牙特征值对应服务的 uuid

    需要通过 getBLEDeviceServices 接口获取

    characteristicIdstring

    蓝牙特征值的 uuid

    需要通过 getBLEDeviceCharacteristics 接口获取

    valueArrayBuffer

    需要写入的二进制数据

    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型默认值必填说明最低版本
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    使用说明

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

    • 并行调用多次读写接口存在读写失败的可能性

    • 接口不会对写入数据包大小做限制,但系统与蓝牙设备会确定蓝牙 4.0 单次传输的数据大小,超过最大字节数后会发生写入错误,建议每次写入不超过 20 字节

    • 安卓平台上,在调用 notify 成功后立即调用 write 接口,在部分机型上会发生 10008 系统错误

    • 若单次写入数据过长,iOS 平台上存在系统不会有任何回调的情况(包括错误回调)

    上一篇读取BLE设备特征值数据
    下一篇启用BLE设备特征值订阅
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们