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

onSPPConnectionStateChange

监听 SPP 连接状态变化事件。

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

功能说明

当某条 SPP 连接建立成功或断开（对端关闭、异常断链、本地关闭）时触发。可用于感知连接建立、被动断开等情况。

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

参数

参数	类型	必填	说明
callback	function	是	状态变化时的回调函数，入参为 OnSPPConnectionStateChangeListenerResult

回调参数 OnSPPConnectionStateChangeListenerResult

字段	类型	说明
socketId	number	连接标识
deviceId	string	该连接对应的设备 id
connected	boolean	是否处于已连接状态；false 表示已断开

示例

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

UTSBLE.onSPPConnectionStateChange((res) => {
    console.log('socketId =', res.socketId, 'connected =', res.connected);
    if (!res.connected) {
        console.log('连接已断开 deviceId =', res.deviceId);
    }
});