BP_UniversalEndpointComp

基本信息

类型: Blueprint (ActorComponent)
父类: UEndpointComponent
源文件: /Game/Blueprints/Component/BP_UniversalEndpointComp.BP_UniversalEndpointComp
模块: Content/Blueprints/Component

功能概述

BP_UniversalEndpointComp 是通用指令端点组件，继承 CharacterControl 的 UEndpointComponent。它添加了 CommandReceivedDispatcher 事件分发器委托，让其他蓝图可以动态绑定到该端点的指令接收事件，无需创建新子类。

设计用意

UEndpointComponent 提供了 OnCommandReceived (BlueprintImplementableEvent) 用于蓝图处理指令，但该事件只能在子类中覆盖，外部蓝图无法直接订阅。BP_UniversalEndpointComp 通过添加一个动态多播委托 CommandReceivedDispatcher，在收到指令时将事件转发为委托广播，使外部蓝图也能监听该端点的指令接收事件，提升了端点组件的可组合性。

职责范围

BP_UniversalEndpointComp 负责提供外部的指令接收委托，将内部事件转发为可外部订阅的委托。它不处理具体的指令逻辑（由外部订阅者负责），也不涉及路由器逻辑（由 UCommandRouter 负责）。

项目内依赖

依赖项	关系	源文件
UEndpointComponent	父类	CharacterControl 插件

外部视角

BP_UniversalEndpointComp 是 UEndpointComponent 的蓝图子类，从外部调用者视角：

公开属性（蓝图可读写）

CommandReceivedDispatcher（多播委托）— 指令接收事件分发器

核心行为

继承 UEndpointComponent 的 OnCommandReceived（BlueprintImplementableEvent），在收到指令时触发
在 OnCommandReceived 实现中将指令转发为 CommandReceivedDispatcher 广播
外部蓝图可通过 Bind Event 节点绑定到 CommandReceivedDispatcher，无需新建 Endpoint 子类

EventGraph 事件

事件	类型	触发时机	行为
`事件开始运行`	原生覆盖 (BeginPlay)	组件创建时	预留（当前无连线逻辑）
`事件Tick`	原生覆盖	每帧	预留（当前无连线逻辑）
`事件OnCommandReceived`	委托事件 (EndpointComponent)	收到指令路由系统派发的 CommandPacket	调用 CommandReceivedDispatcher 广播给所有绑定的外部蓝图

外部交互方式

作为 BP_TestChar 的组件自动创建
外部蓝图通过组件引用的方式获取实例，绑定 CommandReceivedDispatcher

使用方法

BP_UniversalEndpointComp 在项目中的典型调用流程：

指令转发流程 — UCommandRouter 派发指令 → OnCommandReceived 触发 → 调用 CommandReceivedDispatcher 广播 → 所有绑定了该委托的外部蓝图（如 BP_Hud 的 DealWithCommand）同时收到指令
事件绑定流程 — 外部蓝图（如 BP_Hud 的 BeginPlay）→ 获取 BP_UniversalEndpointComp 引用 → Bind Event to CommandReceivedDispatcher → 创建自定义事件处理指令

用例

引用方	路径	用途
BP_TestChar	`/Game/Blueprints/BP_TestChar`	作为端点组件添加到角色，接收并转发指令
BP_Hud	`/Game/Blueprints/BP_Hud`	在 EventGraph 中引用，用于端点通信

3.2 KiB Raw Blame History Unescape Escape