45 lines
3.0 KiB
Markdown
45 lines
3.0 KiB
Markdown
# BP_UniversalEndpointComp
|
||
|
||
## 基本信息
|
||
- **类型**: Blueprint (ActorComponent)
|
||
- **父类**: UEndpointComponent
|
||
- **源文件**: /Game/Blueprints/Component/BP_UniversalEndpointComp.BP_UniversalEndpointComp
|
||
- **模块**: Content
|
||
|
||
## 功能概述
|
||
BP_UniversalEndpointComp 是通用指令端点组件，继承 CharacterControl 的 UEndpointComponent。它添加了 `CommandReceivedDispatcher` 事件分发器委托，让其他蓝图可以动态绑定到该端点的指令接收事件，无需创建新子类。
|
||
|
||
## 设计用意
|
||
UEndpointComponent 提供了 OnCommandReceived (BlueprintImplementableEvent) 用于蓝图处理指令，但该事件只能在子类中覆盖，外部蓝图无法直接订阅。BP_UniversalEndpointComp 通过添加一个动态多播委托 `CommandReceivedDispatcher`，在收到指令时将事件转发为委托广播，使外部蓝图也能监听该端点的指令接收事件，提升了端点组件的可组合性。
|
||
|
||
## 职责范围
|
||
BP_UniversalEndpointComp 负责提供外部的指令接收委托，将内部事件转发为可外部订阅的委托。它不处理具体的指令逻辑（由外部订阅者负责），也不涉及路由器逻辑（由 UCommandRouter 负责）。
|
||
|
||
## 项目内依赖
|
||
| 依赖项 | 关系 | 源文件 |
|
||
|--------|------|--------|
|
||
| UEndpointComponent | 父类 | CharacterControl 插件 |
|
||
|
||
## 对外接口
|
||
- **蓝图变量**：
|
||
- `CommandReceivedDispatcher` (动态多播委托) -- 指令接收事件分发器，is_instance_editable，其他蓝图可绑定此委托接收指令通知
|
||
- **继承自 UEndpointComponent 的接口**：
|
||
- `EndpointState` (FEndpointState) -- 端点状态，含 `EndpointGuid`、`InterestedTags` (FGameplayTagContainer)、`bIsActive`、`bIsContinuousFriendly`、`bIsAsynchronous`
|
||
- `OnCommandReceived(const FCommandPacket& Command)` (BlueprintImplementableEvent) -- 收到匹配指令时调用，可在蓝图子类或本蓝图 EventGraph 中实现
|
||
- `OnEndpointStateChanged` (FOnEndpointStateChanged) -- 状态变化委托
|
||
- `OnCommandOutput` (FOnCommandOutput) -- 命令输出委托
|
||
- **继承自 ICommandEndpoint 接口**：
|
||
- `ReceiveCommand_BP(const FCommandPacket& Command)` (BlueprintNativeEvent) -- 蓝图版本的指令接收入口
|
||
- `GetEndpointDispatcher_BP()` (BlueprintNativeEvent) -- 获取端点分发器
|
||
|
||
## 使用方法
|
||
- 作为 ActorComponent 添加到 BP_TestChar 等需要通用指令处理的 Actor 上
|
||
- 配置 `EndpointState.InterestedTags` 指定该端点关注的 GameplayTag 集合
|
||
- 外部蓝图通过绑定 `CommandReceivedDispatcher` 委托来监听指令，无需创建新的端点子类
|
||
- EventGraph 中当 `OnCommandReceived` 触发时，自动广播 `CommandReceivedDispatcher`，将内部事件转发为外部委托
|
||
- `UCommandRouterComponent` 在 BeginPlay 时通过 `AutoRegisterEndpoints` 自动发现并注册本组件
|
||
|
||
## 用例
|
||
- BP_TestChar 的组件，作为通用指令端点接收路由来的指令
|
||
- 外部蓝图通过绑定 `CommandReceivedDispatcher` 订阅指令事件
|