# AMyPlayerController

## 基本信息
- **类型**: UCLASS
- **父类**: APlayerController
- **源文件**: Source/lonese/MyPlayerController.h
- **模块**: lonese

## 功能概述
AMyPlayerController 是自定义 PlayerController，提供三种行为：GetOwnedPawn（GetPawn 的蓝图包装）、CalcCamera 覆写（调用 AActor::CalcCamera 以禁用内置视口目标混合）、AcknowledgePossession 覆写（触发 OnClientPossessFinished BlueprintImplementableEvent，供蓝图实现 Possess 后逻辑）。

## 设计用意
作为 C++ 与蓝图之间的桥梁。CalcCamera 覆写阻止默认摄像机系统干扰 ACameraPawn 的工作。OnClientPossessFinished 提供蓝图钩子，满足 Possess 后初始化（如 UI 设置、游戏性逻辑）的常见需求。

## 职责范围
PlayerController 的自定义层：禁用默认摄像机混合计算、提供蓝图 Possess 事件通知。不实现摄像机逻辑（委托给 ACameraPawn 通过视口目标机制处理）。

## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
|（无）| — | 不依赖任何项目内类，仅引用引擎头文件 |

## 对外接口
**C++ / Blueprint（UFUNCTION）**
- `GetOwnedPawn() -> APawn*` (BlueprintCallable) — 返回当前控制的 Pawn。对 APlayerController::GetPawn() 的蓝图友好包装。

**Blueprint（UFUNCTION，BlueprintImplementableEvent）**
- `OnClientPossessFinished(APawn* P)` — 当 Possess 完成时由 C++ 层触发的蓝图事件。在 AcknowledgePossession 中调用，参数为被 Possess 的 Pawn。蓝图可覆写此事件实现 Possess 后初始化逻辑（如 UI 设置、状态重置）。

**C++（覆写基类）**
- `CalcCamera(float DeltaTime, FMinimalViewInfo& OutResult)` — 覆写 APlayerController::CalcCamera，调用 `AActor::CalcCamera` 以禁用内置视口目标混合（viewport blending），确保 ACameraPawn 的视口目标设置不被干扰。
- `AcknowledgePossession(APawn* P)` — 覆写 APlayerController::AcknowledgePossession，在调用 Super 后触发 OnClientPossessFinished 蓝图事件。

## 使用方法
- 类声明：`Source/lonese/MyPlayerController.h:13-29`
- GetOwnedPawn 实现：`Source/lonese/MyPlayerController.cpp:6-8` — 调用并返回 `GetPawn()`。
- BeginPlay 实现：`Source/lonese/MyPlayerController.cpp:11-13` — 仅调用 Super。
- CalcCamera 覆写：`Source/lonese/MyPlayerController.cpp:16-18` — 调用 `AActor::CalcCamera` 禁用摄像机混合。
- AcknowledgePossession 覆写：`Source/lonese/MyPlayerController.cpp:21-24` — Super 后触发 OnClientPossessFinished。

## 用例
- **BP_TestCtl** — 项目玩家控制器蓝图，继承自 AMyPlayerController，在蓝图中实现 OnClientPossessFinished 事件处理 Possess 完成后逻辑，并定义 SetupControllingPawn 自定义函数处理控制权切换。
  - `Document/Content/Blueprints/BP_TestCtl.md:5`（父类为 AMyPlayerController）
  - `Document/Content/Blueprints/BP_TestCtl.md:10,13`（实现 OnClientPossessFinished，利用禁用摄像机计算特性）
  - `Document/Content/Blueprints/_relationships.md:8,38`（输入管线中的角色）