Taro.writeBLECharacteristicValue(option)

向低功耗蓝牙设备特征值中写入二进制数据。注意：必须设备的特征值支持 write 才可以成功调用。

注意

• 并行调用多次会存在写失败的可能性。
• 小程序不会对写入数据包大小做限制，但系统与蓝牙设备会限制蓝牙4.0单次传输的数据大小，超过最大字节数后会发生写入错误，建议每次写入不超过20字节。
• 若单次写入数据过长，iOS 上存在系统不会有任何回调的情况（包括错误回调）。
• 安卓平台上，在调用 notifyBLECharacteristicValueChange 成功后立即调用 writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误

参考文档

类型

(option: Option) => Promise<Promised>

参数

Promised

参数	类型	说明
errMsg	string	成功：ok，错误：详细信息

Option

参数	类型	必填	说明
characteristicId	string	是	蓝牙特征值的 uuid
deviceId	string	是	蓝牙设备 id
serviceId	string	是	蓝牙特征值对应服务的 uuid
value	ArrayBuffer	是	蓝牙设备特征值对应的二进制值
complete	(res: BluetoothError) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）
fail	(res: BluetoothError) => void	否	接口调用失败的回调函数
success	(res: BluetoothError) => void	否	接口调用成功的回调函数

示例代码

// 向蓝牙设备发送一个0x00的16进制数据

let buffer = new ArrayBuffer(1)

let dataView = new DataView(buffer)

dataView.setUint8(0, 0)

Taro.writeBLECharacteristicValue({

// 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取

deviceId,

// 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取

serviceId,

// 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取

characteristicId,

// 这里的value是ArrayBuffer类型

value: buffer,

success: function (res) {

console.log('writeBLECharacteristicValue success', res.errMsg)

}

})

API 支持度

API	微信小程序	H5	React Native
Taro.writeBLECharacteristicValue	✔️