# BP_CameraPawn

## 基本信息
- **类型**: Blueprint (Pawn)
- **父类**: ACameraPawn
- **源文件**: /Game/Blueprints/BP_CameraPawn.BP_CameraPawn
- **模块**: Content

## 功能概述
BP_CameraPawn 是分离式第三人称摄像机的蓝图实现，继承 C++ 的 ACameraPawn。在蓝图层面配置摄像机参数（初始旋转、臂长范围、速度等），并提供编辑器内可视化调整能力。

## 设计用意
ACameraPawn 在 C++ 层提供了完整的 SpringArm+Camera 组件和缩放、旋转、移动、重置逻辑。BP_CameraPawn 作为蓝图配置层，将摄像机的默认参数（初始旋转 -60 度、初始臂长 1200、臂长范围 300-3000、旋转速度 2.0、缩放速度 10.0、移动速度 10.0、移动限制 800）暴露在蓝图中，方便在编辑器内调整和迭代。

## 职责范围
BP_CameraPawn 负责摄像机参数的蓝图级配置和编辑器内可视化调整。底层的摄像机变换逻辑（SpringArm 的臂长插值、旋转计算、移动偏移等）全部由 ACameraPawn C++ 层处理。

## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| ACameraPawn | 父类 | C++ 源码 |

## 对外接口
- **继承自 ACameraPawn 的 BlueprintCallable 函数**：
  - `CameraZoom(const FInputActionValue& Value)` -- 摄像机缩放，调整 SpringArm 臂长
  - `CameraRotate(const FInputActionValue& Value)` -- 摄像机旋转，调整 SpringArm 的旋转偏移
  - `CameraMove(const FInputActionValue& Value)` -- 摄像机平移，调整 SpringArm 的 SocketOffset
  - `CameraReset(const FInputActionValue& Value)` -- 重置摄像机到默认位置和旋转
- **继承自 ACameraPawn 的 BlueprintReadOnly 属性**：
  - `SpringArmComponent` (USpringArmComponent*) -- SpringArm 组件引用
  - `CameraComponent` (UCameraComponent*) -- Camera 组件引用
  - `FollowTarget` (APawn*) -- 跟随目标 Pawn（VisibleInstanceOnly）
- **蓝图可调的配置参数**（EditDefaultsOnly, BlueprintReadOnly）：
  - `InitialRotation` = FRotator(-60, 0, 0) -- 初始俯仰角
  - `InitialArmLength` = 1200.0f -- 初始臂长
  - `RotateSpeed` = 2.0f -- 旋转速度
  - `ZoomSpeed` = 10.0f -- 缩放速度
  - `MoveSpeed` = 10.0f -- 平移速度
  - `MaxArmLength` = 3000.0f / `MinArmLength` = 300.0f -- 臂长范围
  - `CameraMoveClamp` = 800.0 -- 平移限制范围

## 使用方法
- 通过 BP_TestChar (AMyCharacter) 的 `CameraActorClass` 属性配置，角色 Possess 时自动生成摄像机实例
- 继承自 ACameraPawn，C++ 层提供了完整的 SpringArm+Camera 组件和变换逻辑
- 蓝图层面可在 EventGraph 中响应事件（event_count=3，node_count=3）
- 配置参数均为 `EditDefaultsOnly`，在蓝图类默认值中调整摄像机行为，无需修改 C++ 代码
- ACameraPawn 的 Tick() 处理每帧的臂长插值、旋转跟随和移动偏移，蓝图不参与底层变换
- `FollowTarget` 在运行时由 SetFollowTarget 逻辑自动设置为当前控制的角色

## 用例
- BP_TestChar (AMyCharacter) 中 `CameraActorClass` 属性引用，作为角色的分离式摄像机
- 被 Possess 角色时自动生成，跟随 `FollowTarget` Pawn