# BP_ControllerComp

## 基本信息
- **类型**: Blueprint (ActorComponent)
- **父类**: BP_EndpointComp_C (即 UEndpointComponent)
- **源文件**: /Game/Blueprints/Component/BP_ControllerComp.BP_ControllerComp
- **模块**: Content

## 功能概述
BP_ControllerComp 是自定义控制器端点组件，管理摄像机的缩放和跟随模式。持有多个摄像机相关配置参数：移动速度（MoveSpeed）、臂长范围（MinArmLength / MaxArmLength）、缩放速度（ZoomSpeed）、跟随模式开关（IsFollowMode）以及跟随目标角色引用（FollowedChar）。

## 设计用意
BP_ControllerComp 是 BP_TestChar 上最复杂的端点组件，负责处理摄像机控制指令。它持有自己的配置参数而非依赖 ACameraPawn 的默认值，表明它可能在运行时动态调整摄像机行为，例如切换跟随模式、调整臂长和移动速度。IsFollowMode 和 FollowedChar 的组合支持摄像机锁定特定角色的功能。

## 职责范围
BP_ControllerComp 负责摄像机控制参数的管理、跟随模式的切换以及摄像机移动指令的处理。摄像机实际的 SpringArm 变换和空间计算由 ACameraPawn 及其 SpringArm 组件负责。

## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| BP_EndpointComp_C | 父类 | CharacterControl 插件 |
| UEndpointComponent | 祖父类 | CharacterControl 插件 |
| ACharacter | 引用 (FollowedChar) | 引擎内置 |

## 对外接口
- **蓝图函数**：
  - `MoveController(A: GameplayTag, InVec: Vector)` -- 摄像机移动指令处理，接收 GameplayTag 和移动向量
  - `RotateController(A: GameplayTag, InVec: Vector)` -- 摄像机旋转指令处理
  - `ZoomCamera(A: GameplayTag, InVec: Vector)` -- 摄像机缩放指令处理，通过 InVec 中的值调整臂长
  - `ResetControllerLocation(DiscreteMeta: DiscreteMeta)` -- 摄像机位置重置，接收离散命令元数据
  - `TickFollowChar()` -- 跟随模式每帧更新，将摄像机位置锁定到 FollowedChar
- **蓝图变量**（均为 is_instance_editable）：
  - `MoveSpeed` (double) -- 摄像机移动速度
  - `MinArmLength` (double) -- 最小臂长
  - `MaxArmLength` (double) -- 最大臂长
  - `ZoomSpeed` (double) -- 缩放速度
  - `IsFollowMode` (bool) -- 是否启用跟随模式
  - `FollowedChar` (Character*) -- 跟随目标角色引用
- **继承自 (BP_EndpointComp_C / UEndpointComponent) 的接口**：
  - `EndpointState` -- 端点状态，含 `InterestedTags` 配置摄像机控制相关标签
  - `OnCommandReceived` -- 收到指令时的处理入口
- **EventGraph**：含 6 个事件和 27 个节点，处理摄像机控制的核心逻辑

## 使用方法
- 作为 ActorComponent 添加到 BP_TestChar
- 在组件实例上配置 `MoveSpeed`、`MinArmLength`、`MaxArmLength`、`ZoomSpeed` 等摄像机参数
- 通过 `EndpointState.InterestedTags` 配置关注的摄像机控制 GameplayTag（如 "Camera.Move"、"Camera.Zoom"、"Camera.Rotate"、"Camera.Reset"）
- 开启 `IsFollowMode` 并设置 `FollowedChar` 可启用角色跟随模式
- `MoveController`、`RotateController`、`ZoomCamera` 函数由 OnCommandReceived 事件根据指令标签分发调用
- `TickFollowChar()` 在 EventGraph 的 Tick 事件中调用，实现每帧跟随
- `UCommandRouterComponent` 自动发现并注册本组件

## 用例
- BP_TestChar 的组件，处理摄像机控制指令
- 通过配置参数在运行时动态调整 ACameraPawn 的行为（臂长、速度、跟随目标）