[UTS蓝牙插件文档] onSPPReceiveData 接口描述文档

onSPPReceiveData

监听 SPP 连接收到数据事件。

所属能力组：经典蓝牙 SPP（Serial Port Profile / RFCOMM）串口通信
支持平台：Android、鸿蒙 NEXT（iOS 不支持，统一回调错误码 10020）

功能说明

SPP 采用「推送式」接收数据：已建立的连接（无论客户端主动连接还是服务端 accept 得到的）收到对端数据后，会通过本事件主动上报，无需调用方轮询读取。

对齐插件其它监听接口的设计：仅支持单个回调，多次调用 onSPPReceiveData 会覆盖上一次注册的回调；请使用 offSPPReceiveData 取消。

参数

参数	类型	必填	说明
callback	function	是	收到数据时的回调函数，入参为 OnSPPReceiveDataListenerResult

回调参数 OnSPPReceiveDataListenerResult

字段	类型	说明
socketId	number	收到数据的 SPP 连接标识
deviceId	string	该连接对应的设备 id
value	number[]	收到的二进制数据（字节数组）

示例

import * as UTSBLE from '@/uni_modules/xl-uts-bluetooth/jssdk/BLE.js';

UTSBLE.onSPPReceiveData((res) => {
    console.log('socketId =', res.socketId, 'deviceId =', res.deviceId);
    console.log('收到数据 =', res.value); // number[]
});