58 lines
4.2 KiB
Markdown
58 lines
4.2 KiB
Markdown
# BP_TestChar
|
||
|
||
## 基本信息
|
||
- **类型**: Blueprint (Actor)
|
||
- **父类**: AMyCharacter
|
||
- **源文件**: /Game/Blueprints/BP_TestChar.BP_TestChar
|
||
- **模块**: Content
|
||
|
||
## 功能概述
|
||
BP_TestChar 是玩家主角的蓝图实现，继承 C++ 的 AMyCharacter。它通过添加 CharacterControl 插件的路由组件来扩展角色能力，在蓝图层面组合移动、指令路由和摄像机控制。
|
||
|
||
## 设计用意
|
||
AMyCharacter 在 C++ 层提供了移动和摄像机 Pawn 创建的基础能力。BP_TestChar 在蓝图层面通过组件化的方式组装角色功能：添加 UCommandRouterComponent 将角色变成指令路由中心，添加各种 ICommandEndpoint 组件处理不同类型的指令。作为项目的核心 Pawn，它是指令系统和角色能力的"组装层"——新功能通过添加新的端点组件来扩展，而非修改 C++ 代码。
|
||
|
||
## 职责范围
|
||
BP_TestChar 是角色的蓝图配置层，负责添加并配置 CharacterControl 路由组件和端点组件，实现角色重叠、Tick 等蓝图级逻辑。移动逻辑由 AMyCharacter C++ 层处理，摄像机逻辑由 ACameraPawn 负责。
|
||
|
||
## 项目内依赖
|
||
| 依赖项 | 关系 | 源文件 |
|
||
|--------|------|--------|
|
||
| AMyCharacter | 父类 | /Game/Blueprints/BP_TestChar (C++ 继承) |
|
||
| ACameraPawn | 间接（CameraActorClass） | /Game/Blueprints/BP_CameraPawn |
|
||
| UCommandRouterComponent | 组件 | CharacterControl 插件 |
|
||
| BP_UniversalEndpointComp | 组件 | /Game/Blueprints/Component/BP_UniversalEndpointComp |
|
||
| BP_MoveInput | 组件 | /Game/Blueprints/Component/BP_MoveInput |
|
||
| BP_ControllerComp | 组件 | /Game/Blueprints/Component/BP_ControllerComp |
|
||
| BP_SayHello | 组件 | /Game/Blueprints/Component/BP_SayHello |
|
||
|
||
## 对外接口
|
||
- **继承自 AMyCharacter 的 BlueprintCallable 函数**：
|
||
- `Move(const FInputActionValue& Value)` -- 移动输入处理，供 EnhancedInput 绑定调用
|
||
- `BeginRun(const FInputActionValue& Value)` / `StopRun(const FInputActionValue& Value)` -- 奔跑切换
|
||
- `BeginCrouch(const FInputActionValue& Value)` / `StopCrouch(const FInputActionValue& Value)` -- 蹲伏切换
|
||
- `IsRunning() const` / `IsCrouching() const` -- 状态查询
|
||
- **继承自 AMyCharacter 的 BlueprintReadOnly 属性**：
|
||
- `DefaultMapping` (UInputMappingContext*) -- 默认输入映射上下文
|
||
- `MoveAction`, `RunAction`, `CrouchAction`, `CameraMoveAction`, `CameraZoomAction`, `CameraResetAction`, `CameraRotateAction` -- 各输入动作引用
|
||
- `CameraActorClass` (TSubclassOf<ACameraPawn>) -- 摄像机 Pawn 类，设置为 BP_CameraPawn
|
||
- **身上的组件作为对外能力**：
|
||
- `UCommandRouterComponent` -- 指令路由中心，通过 RegisterEndpoint / InputCommand 接收和分发指令
|
||
- `BP_UniversalEndpointComp` -- 通用端点，对外暴露 `CommandReceivedDispatcher` 动态多播委托
|
||
- `BP_MoveInput` -- 移动端点，对外暴露 `CharMove` (CharacterMovementComponent*) 变量
|
||
- `BP_ControllerComp` -- 摄像机控制端点，对外暴露 `MoveController`、`RotateController`、`ZoomCamera`、`ResetControllerLocation`、`TickFollowChar` 函数及摄像机配置参数
|
||
- `BP_SayHello` -- 测试端点，验证指令路由系统
|
||
|
||
## 使用方法
|
||
- 在 BP_TestMode 中设置为 `DefaultPawnClass`，作为项目的默认 Pawn
|
||
- 在蓝图编辑器中添加 CharacterControl 路由和端点组件：`UCommandRouterComponent` 作为指令路由器，`BP_UniversalEndpointComp`、`BP_MoveInput`、`BP_ControllerComp`、`BP_SayHello` 作为各类指令端点
|
||
- 通过父类 AMyCharacter 的 `CameraActorClass` 属性指定 BP_CameraPawn 作为分离式摄像机
|
||
- 配置父类的 InputAction 属性（MoveAction、RunAction 等）连接 EnhancedInput 系统
|
||
- 各端点组件通过 `EndpointState.InterestedTags` 配置关注的 GameplayTag，UCommandRouterComponent 的 `AutoRegisterEndpoints` 在 BeginPlay 时自动注册所有组件上的端点
|
||
- 指令链路：EnhancedInput -> UCommandInputComponent -> UCommandRouterComponent -> 匹配的端点组件
|
||
|
||
## 用例
|
||
- BP_TestMode 的 `DefaultPawnClass`，作为玩家进入关卡时的默认角色
|
||
- 身上挂载的 `BP_UniversalEndpointComp`、`BP_MoveInput`、`BP_ControllerComp`、`BP_SayHello` 作为该角色的指令处理端点
|
||
- `CameraActorClass` 属性引用 BP_CameraPawn，角色被 Possess 时自动生成摄像机
|