bilibili小程序

bl.getBLEMTU(Object object)

基础库版本 >= 3.81.0 支持。

获取蓝牙低功耗的最大传输单元。需在 bl.createBLEConnection 调用成功后调用。

参数说明

Object object

属性	类型	默认值	必填	说明	版本
deviceId	string		是	蓝牙设备 id	3.81.0
writeType	string	write	否	写模式（iOS 特有参数）	3.81.0
success	function		否	接口调用成功的回调函数	3.81.0
fail	function		否	接口调用失败的回调函数	3.81.0
complete	function		否	接⼝调⽤结束的回调函数（调⽤成功、失败都会执⾏）	3.81.0

writeType 的合法值

值	说明
write	有回复写
writeNoResponse	无回复写

success参数说明

Object res

属性	类型	说明	版本
mtu	number	最大传输单元

示例代码

bl.getBLEMTU({
  deviceId: '',
  writeType: 'write',
  success (res) {
    console.log(res)
  }
})

注意

小程序中 MTU 为 ATT_MTU，包含 Op-Code 和 Attribute Handle 的长度，实际可以传输的数据长度为 ATT_MTU - 3。
iOS 系统中 MTU 为固定值；安卓系统中，MTU 会在系统协商成功之后发生改变，建议使用 bl.onBLEMTUChange 监听。

错误异常

错误码	错误信息	场景
0	ok	正常
-1	already connect	已连接
10000	not init	未初始化蓝牙适配器
10001	not available	当前蓝牙适配器不可用
10002	no device	没有找到指定设备
10003	connection fail	连接失败
10004	no service	没有找到指定服务
10005	no characteristic	没有找到指定特征
10006	no connection	当前连接已断开
10007	property not support	当前特征不支持此操作
10008	system error	其余所有系统上报的异常
10009	system not support	Android 系统特有，系统版本低于 4.3 不支持 BLE
10012	operate time out	连接超时
10013	invalid_data	连接 deviceId 为空或者是格式不正确
10014	invalid param	参数不正确

← bl.getBLEDeviceCharacteristics bl.getBLEDeviceRSSI →