bl.setBLEMTU(Object object)
仅 Android支持,且基础库版本 >=
3.81.0
。
协商设置蓝牙低功耗的最大传输单元 (Maximum Transmission Unit, MTU)。需在 bl.createBLEConnection 调用成功后调用。仅安卓系统 5.1 以上版本有效,iOS 因系统限制不支持。
参数说明
Object object
属性 | 类型 | 默认值 | 必填 | 说明 | 版本 |
---|---|---|---|---|---|
deviceId | string | 是 | 蓝牙设备 id | 3.81.0 | |
mtu | number | 是 | 最大传输单元。设置范围为 (22,512) 区间内,单位 bytes | 3.81.0 | |
success | function | 否 | 接口调用成功的回调函数 | 3.81.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 3.81.0 | |
complete | function | 否 | 接⼝调⽤结束的回调函数(调⽤成功、失败都会执⾏) | 3.81.0 |
success/fail参数说明
Object res
属性 | 类型 | 说明 | 版本 |
---|---|---|---|
mtu | number | 最终协商的 MTU 值,与传入参数一致。 |
示例代码
// 必须在这里的回调才能获取
bl.onBLECharacteristicValueChange(function(characteristic) {
console.log('characteristic value comed:', characteristic)
})
bl.setBLEMTU({
// 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
deviceId,
mtu,
success (res) {
console.log('setBLEMTU:', res.mtu)
}
})