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

closeSPPServer

关闭 SPP 服务端监听（注销 UUID 服务并释放监听套接字）。

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

功能说明

关闭 createSPPServer 创建的监听套接字，对应的 serverId 从插件服务端表中移除。关闭后：

• 蓝牙子系统中注册的该 UUID 服务被删除，后续客户端将无法再连入。
• 不会再触发 onSPPClientCreateByServer 事件。

关闭一条已建立的连接请使用 closeSPPClient。

请求参数 CloseSPPServerOptions

参数	类型	必填	默认值	说明
serverId	number	是	-	要关闭的服务端监听套接字的唯一标识
success	function	否	-	接口调用成功的回调函数
fail	function	否	-	接口调用失败的回调函数
complete	function	否	-	接口调用结束的回调函数（成功、失败都会执行）

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

成功回调结果 ApiCommonResult

字段	类型	说明
errCode	number	错误码，成功时为 0
errMsg	string	错误信息，成功时为 closeSPPServer:ok

返回 Promise

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

错误码

错误码	说明
10019	SPP 服务端不存在（serverId 无效）
10000	未初始化蓝牙适配器
10008	系统异常
10020	当前平台不支持 SPP（iOS）

示例

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

UTSBLE.closeSPPServer({
    serverId: 1,
    success: () => {
        console.log('服务端已关闭');
    },
    fail: (err) => {
        console.error('关闭失败', err.errCode, err.errMsg);
    },
});