60 lines
3.2 KiB
Markdown
60 lines
3.2 KiB
Markdown
# 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 中引用，用于端点通信 |
|