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

onSPPClientCreateByServer

监听「服务端 accept 得到客户端连接」事件。

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

功能说明

当 createSPPServer 创建的服务端接受到一个新的客户端连接时触发，上报该连接的 socketId（后续通过 writeSPPValue 收发、通过 closeSPPClient 关闭）。

对齐插件其它监听接口的设计：仅支持单个回调，多次调用 onSPPClientCreateByServer 会覆盖上一次注册的回调；请使用 offSPPClientCreateByServer 取消。
注意：同一服务端可能连续 accept 到多个连接，插件会在每次 accept 后自动续订阅，因此本事件会被多次触发。

参数

参数	类型	必填	说明
callback	function	是	有客户端连入时的回调函数，入参为 OnSPPClientCreateByServerListenerResult

回调参数 OnSPPClientCreateByServerListenerResult

字段	类型	说明
serverId	number	接受连接的服务端监听套接字标识
socketId	number	新建立的连接标识（后续收发 / 关闭以此索引）
deviceId	string	发起连接的对端设备 id（鸿蒙侧 accept 回调不提供设备地址，可能为空串）

示例

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

UTSBLE.onSPPClientCreateByServer((res) => {
    console.log('serverId =', res.serverId, 'socketId =', res.socketId, 'deviceId =', res.deviceId);
    // 可对该 socketId 直接收发数据
});