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

getSPPServers

获取当前所有存活的 SPP 服务端列表。

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

功能说明

返回插件当前持有的全部 SPP 服务端监听套接字信息（由 createSPPServer 创建，尚未被 closeSPPServer 关闭的）。

返回的是当前存活的服务端快照，适合用于查询状态或界面刷新。

请求参数 GetSPPServersOptions

参数	类型	必填	默认值	说明
success	function	否	-	接口调用成功的回调函数
fail	function	否	-	接口调用失败的回调函数
complete	function	否	-	接口调用结束的回调函数（成功、失败都会执行）

不传 success / fail / complete 时，接口返回 Promise。

成功回调结果 GetSPPServersSuccessCallbackResult

字段	类型	说明
servers	SPPServerInfo[]	当前所有存活的 SPP 服务端列表
errMsg	string	错误信息，成功时为 getSPPServers:ok

SPPServerInfo

字段	类型	说明
serverId	number	服务端监听套接字标识
uuid	string	监听的 RFCOMM 服务 UUID

返回 Promise

未传任何回调时返回 Promise<GetSPPServersSuccessCallbackResult>。

错误码

错误码	说明
10000	未初始化蓝牙适配器
10008	系统异常
10020	当前平台不支持 SPP（iOS）

示例

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

UTSBLE.getSPPServers({
    success: (res) => {
        res.servers.forEach((s) => {
            console.log('serverId =', s.serverId, 'uuid =', s.uuid);
        });
    },
});

// Promise 风格
const res = await UTSBLE.getSPPServers();
console.log('服务端数量 =', res.servers.length);