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

closeSPPClient

关闭一条已建立的 SPP 连接（客户端主动连接，或服务端 accept 得到的连接均适用）。

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

功能说明

断开并释放指定 socketId 占用的原生 socket 资源。关闭后：

• 该连接会通过 onSPPConnectionStateChange 上报 connected: false。
• 该 socketId 从插件的连接表中移除，后续再对其调用 writeSPPValue 会返回 10019。

关闭服务端监听套接字请使用 closeSPPServer。

请求参数 CloseSPPClientOptions

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

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

成功回调结果 ApiCommonResult

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

返回 Promise

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

错误码

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

示例

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

UTSBLE.closeSPPClient({
    socketId: 1,
    success: () => {
        console.log('已关闭连接');
    },
    fail: (err) => {
        console.error('关闭失败', err.errCode, err.errMsg);
    },
});