【小程序开发】蓝牙设备API——单点蓝牙应用程序编程接口整理（二）

ty.device.getBLEDeviceRSSI

获取 BLE 外设的信号

需引入DeviceKit，且在>=1.2.6版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
deviceId	string		是	设备模型 deviceId 设备 Id
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
signal	number	设备信号 signal 若为 0，则获取失败

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

ty.device.getBLEOnlineState

查询 BLE(thing)本地在线状态

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

Object object

属性	类型	默认值	必填	说明
deviceId	string		是	设备模型 deviceId 设备 Id
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
isOnline	boolean	蓝牙在线状态的回调 boolean 值 isOnline 是否在线

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

ty.device.offBLEBigDataChannelDeviceToAppSuccess

取消监听：大数据从设备传输到 App 成功的事件

需引入DeviceKit，且在>=2.3.1版本才可使用

参数

function callback

取消监听：大数据从设备传输到 App 成功的事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
data	array		是	data

👉 立即开发。 

ty.device.offBLEBigDataChannelProgressEvent

取消监听：BLE(thing)大数据通道传输进度

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

取消监听：BLE(thing)大数据通道传输进度的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	大数据通道传输进度 deviceId 设备 id
progress	number		是	progress 传输进度，范围: 0 - 100

ty.device.offBLEBigDataChannelUploadCloudProgress

取消监听：大数据上传到云端进度的事件

需引入DeviceKit，且在>=2.3.1版本才可使用

参数

function callback

取消监听：大数据上传到云端进度的事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	大数据通道传输进度 deviceId 设备 id
progress	number		是	progress 传输进度，范围: 0 - 100

ty.device.offBLEConnectStatusChange

取消监听：BLE(thing)连接状态变更通知事件

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

取消监听：BLE(thing)连接状态变更通知事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	BLE（thing）连接状态 deviceId: 设备 id
status	string		是	status 状态值 CONNECTED:已连接 CONNECTING:连接中 CONNECT_BREAK:连接失败

ty.device.offBLEScanBindDevice

取消监听：扫描到设备后进行通知

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

取消监听：扫描到设备后进行通知的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	扫描到的设备 ID

ty.device.offBLETransparentDataReport

取消监听：BLE(thing)设备数据透传通道上报通知

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

取消监听：BLE(thing)设备数据透传通道上报通知的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	蓝牙透传数据 deviceId: 设备 id
data	string		是	data: 透传内容

ty.device.onBLEBigDataChannelDeviceToAppSuccess

大数据从设备传输到 App 成功的事件

需引入DeviceKit，且在>=2.3.1版本才可使用

参数

function callback

大数据从设备传输到 App 成功的事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
data	array		是	data

ty.device.onBLEBigDataChannelProgressEvent

BLE(thing)大数据通道传输进度

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

BLE(thing)大数据通道传输进度的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	大数据通道传输进度 deviceId 设备 id
progress	number		是	progress 传输进度，范围: 0 - 100

ty.device.onBLEBigDataChannelUploadCloudProgress

大数据上传到云端进度的事件

需引入DeviceKit，且在>=2.3.1版本才可使用

参数

function callback

大数据上传到云端进度的事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	大数据通道传输进度 deviceId 设备 id
progress	number		是	progress 传输进度，范围: 0 - 100

ty.device.onBLEConnectStatusChange

BLE(thing)连接状态变更通知事件

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

BLE(thing)连接状态变更通知事件的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	BLE（thing）连接状态 deviceId: 设备 id
status	string		是	status 状态值 CONNECTED:已连接 CONNECTING:连接中 CONNECT_BREAK:连接失败

ty.device.onBLEScanBindDevice

扫描到设备后进行通知

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

扫描到设备后进行通知的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	扫描到的设备 ID

ty.device.onBLETransparentDataReport

BLE(thing)设备数据透传通道上报通知

需引入DeviceKit，且在>=3.0.0版本才可使用

参数

function callback

BLE(thing)设备数据透传通道上报通知的回调函数

回调参数 Object res

属性	类型	默认值	必填	说明
deviceId	string		是	蓝牙透传数据 deviceId: 设备 id
data	string		是	data: 透传内容

 👉 立即开发。