BP_MoveInput

基本信息

类型: Blueprint (ActorComponent)
父类: UEndpointComponent
源文件: /Game/Blueprints/Component/BP_MoveInput.BP_MoveInput
模块: Content

功能概述

BP_MoveInput 是移动输入端点组件，持有对 CharacterMovementComponent 的引用（通过 CharMove 变量），将指令系统中的移动指令转化为实际的角色移动。

设计用意

BP_MoveInput 是指令系统和 UE 移动系统之间的桥梁。它持有 CharMove (CharacterMovementComponent*) 引用，在 OnCommandReceived 中接收移动指令（连续指令，如 "Command.Move"），从 FCommandPacket.ContinuousPayload.ContinuousValue 提取移动向量，然后调用 CharacterMovementComponent 的移动接口。这种设计将输入系统和移动系统解耦——指令的生成、路由和执行分别由不同的组件负责。

职责范围

BP_MoveInput 负责接收移动指令并将其转换为 CharacterMovementComponent 的移动调用。移动向量通过连续指令的 ContinuousValue 传入，由 BP_MoveInput 提取并应用。指令的生成由 UCommandInputComponent 负责，指令的路由匹配由 UCommandRouter 负责。

项目内依赖

依赖项	关系	源文件
UEndpointComponent	父类	CharacterControl 插件
UCharacterMovementComponent	引用 (CharMove)	引擎内置

对外接口

蓝图变量：
- CharMove (CharacterMovementComponent*) -- 持有对所属角色的 CharacterMovementComponent 引用，is_instance_editable，可在组件实例上配置
继承自 UEndpointComponent 的接口：
- EndpointState (FEndpointState) -- 端点状态，含 InterestedTags 配置关注的移动指令标签（如 "Command.Move"）
- OnCommandReceived(const FCommandPacket& Command) (BlueprintImplementableEvent) -- 收到移动指令时调用，在 EventGraph 中实现（node_count=22）
- OnEndpointStateChanged / OnCommandOutput -- 状态和输出委托
通过 EventGraph 的行为：
- 从 Command.ContinuousPayload.ContinuousValue 提取移动向量 (FVector3f)
- 调用 CharMove 的移动接口将向量转化为实际角色移动

使用方法

作为 ActorComponent 添加到 BP_TestChar
设置 CharMove 变量指向所属角色的 CharacterMovementComponent
配置 EndpointState.InterestedTags 添加移动相关 GameplayTag（如 "Command.Move"）
设置 EndpointState.bIsContinuousFriendly = true（移动是连续指令）
UCommandRouterComponent 自动发现并注册本组件为端点
当 EnhancedInput 产生移动输入 -> UCommandInputComponent 生成 FCommandPacket -> UCommandRouterComponent 按标签匹配 -> 本组件的 OnCommandReceived 收到指令 -> 从 ContinuousPayload.ContinuousValue 提取 FVector3f -> 调用 CharacterMovementComponent 执行移动

用例

BP_TestChar 的组件，处理移动指令
通过 CharMove 变量连接 CharacterMovementComponent，实现指令到移动的桥接

3.0 KiB Raw Blame History Unescape Escape