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 的行为（臂长、速度、跟随目标）

3.4 KiB Raw Blame History Unescape Escape