44 lines
2.9 KiB
Markdown
44 lines
2.9 KiB
Markdown
# BP_TestCtl
|
||
|
||
## 基本信息
|
||
- **类型**: Blueprint (PlayerController)
|
||
- **父类**: AMyPlayerController
|
||
- **源文件**: /Game/Blueprints/BP_TestCtl.BP_TestCtl
|
||
- **模块**: Content
|
||
|
||
## 功能概述
|
||
BP_TestCtl 是项目的玩家控制器蓝图实现，继承 C++ 的 AMyPlayerController。它实现了 OnClientPossessFinished 事件用于 Possess 完成后的初始化，并提供 SetupControllingPawn 自定义函数用于控制权切换后的 Pawn 设置。
|
||
|
||
## 设计用意
|
||
BP_TestCtl 利用 AMyPlayerController 的禁用摄像机计算特性（支持 ACameraPawn 分离式摄像机），在蓝图层面提供 Possess 完成后的客户端初始化和 Pawn 设置逻辑。作为一个薄蓝图层，它将 C++ 层的控制器能力暴露给蓝图系统进行配置和扩展。
|
||
|
||
## 职责范围
|
||
BP_TestCtl 负责 Possess 完成时的客户端初始化和控制权切换后的 Pawn 设置。摄像机计算由 C++ 层禁用（CalcCamera 空操作），角色移动由 AMyCharacter 负责，BP_TestCtl 不涉及这些底层逻辑。
|
||
|
||
## 项目内依赖
|
||
| 依赖项 | 关系 | 源文件 |
|
||
|--------|------|--------|
|
||
| AMyPlayerController | 父类 | C++ 源码 |
|
||
|
||
## 对外接口
|
||
- **继承自 AMyPlayerController 的 BlueprintCallable 函数**：
|
||
- `GetOwnedPawn()` -- 获取当前控制的 Pawn，返回 APawn*，供蓝图查询当前 Possess 目标
|
||
- **继承自 AMyPlayerController 的 BlueprintImplementableEvent 事件**：
|
||
- `OnClientPossessFinished(APawn* P)` -- 客户端 Possess 完成时调用，在 BP_TestCtl 的 EventGraph 中实现，客户端收到 Possess 确认后的初始化入口（EventGraph 中 event_count=3）
|
||
- **蓝图自定义函数**：
|
||
- `SetupControllingPawn()` -- 控制权切换后的 Pawn 设置函数，无参数，在 EventGraph 的 18 个节点中被调用
|
||
- **继承自 APlayerController 的标准接口**：所有 APlayerController 的标准事件和函数均可用（如 OnPossess、OnUnPossess、GetPlayerViewPoint 等）
|
||
|
||
## 使用方法
|
||
- 在 BP_TestMode 中设置为 `PlayerControllerClass`，作为项目的默认玩家控制器
|
||
- 父类 AMyPlayerController 重写了 `CalcCamera`（空操作），禁用默认摄像机计算，配合 ACameraPawn 的分离式摄像机设计
|
||
- 父类 AMyPlayerController 重写了 `AcknowledgePossession`，在 Possess 确认后触发 `OnClientPossessFinished` 事件
|
||
- `OnClientPossessFinished` 在蓝图 EventGraph 中实现，用于客户端在 Possess 完成后的初始化逻辑
|
||
- `SetupControllingPawn` 在控制权切换时调用，设置新的受控 Pawn 所需的配置（如 UI 绑定、输入上下文切换等）
|
||
- 作为薄蓝图层，主要职责是将 C++ 层的控制器能力暴露给蓝图系统
|
||
|
||
## 用例
|
||
- BP_TestMode 的 `PlayerControllerClass`，每次玩家加入时实例化
|
||
- `OnClientPossessFinished` 事件连接客户端 Possess 完成的初始化流程
|
||
- `SetupControllingPawn` 在角色切换时重新配置 Pawn 资源
|