作品简介
SimpleTCPClient 在 Unreal Engine 中封装 TCP 客户端连接,提供多通道管理、异步处理、自动重连间隔配置,以及面向蓝图的连接状态接口。
它帮助项目把与外部服务建立和维护连接的工作集中起来。
背景与目标
一个 UE 应用可能同时连接多个外部程序或服务。单次 Socket 连接示例能说明 TCP 收发原理,却没有覆盖多个连接的状态区分和断线后的处理。
插件按通道管理客户端连接,供使用方在蓝图中观察连接状态,并按项目需要配置重试行为。
核心能力
独立通道管理
多个 TCP 客户端通道可分别维护连接,避免不同服务的连接状态混在同一入口。项目可以据通道区分通信对象,并为各自的数据处理建立业务规则。
异步处理与重连
连接相关工作采用异步处理,并可配置断线后的自动重连间隔。重连能力用于重新建立传输通道;是否重发消息、恢复登录或同步业务状态,需要由服务协议和使用方决定。
状态委托与蓝图调用
插件通过委托提供连接状态,蓝图可据此响应连接变化。项目可以把连接与断开的反馈接入界面或业务流程,但消息内容的编码、分帧和解析仍需双方明确。
适用场景
适用于 UE 主动连接外部 TCP 服务、同时维护多个通信目标,或需要在服务断开后按设定间隔重试的应用。项目可分别配置连接通道,并按连接状态处理各服务的业务数据。
适用范围与边界
仅支持 IPv4,不支持域名、IPv6 或加密连接。TCP 提供字节流传输,插件的连接管理不自动定义业务消息边界、序列化格式或重连后的状态恢复。应在实际服务端协议下验证断线、重试和数据处理行为,并核对各通道的配置。
连接配置、原生示例与网络通信导览见 使用教程。
