# BP_MoveInput

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

## 功能概述
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) | 引擎内置 |

## 外部视角

BP_MoveInput 是 UEndpointComponent 的蓝图子类，从外部调用者视角：

**公开属性（蓝图可读写）**
- `CharMove`（CharacterMovementComponent*）— 被控制的角色移动组件引用

**核心行为**
- 继承 UEndpointComponent 的 OnCommandReceived（BlueprintImplementableEvent），接收移动指令
- 从 FCommandPacket.ContinuousPayload.ContinuousValue 中提取移动向量
- 将移动向量应用至 CharMove 引用的 CharacterMovementComponent

**EventGraph 事件**

| 事件 | 类型 | 触发时机 | 行为 |
|------|------|----------|------|
| `事件开始运行` | 原生覆盖 (BeginPlay) | 组件创建时由引擎自动触发 | 获取 Owner → 按类获取 CharacterMovementComponent → 存入 CharMove 变量 |
| `事件Tick` | 原生覆盖 | 每帧 | 预留（当前无连线逻辑） |
| `事件OnCommandReceived` | 委托事件 (EndpointComponent) | 收到指令路由系统派发的 CommandPacket | 解析 ContinuousPayload → 提取 ContinuousValue 向量 → 计算向前/向右移动分量 → 调用 CharacterMovementComponent.AddMovementInput |

**外部交互方式**
- 作为 BP_TestChar 的组件自动创建
- 指令系统通过 UCommandRouter 将匹配标签的指令路由到该组件
- 不暴露自定义事件或委托

## 使用方法

BP_MoveInput 在项目中的典型调用流程：

- **移动输入流程** — 指令系统派发移动指令 → OnCommandReceived 触发 → 解析 CommandPacket.ContinuousPayload.ContinuousValue → 提取移动向量 → 结合角色控制旋转计算前后/左右分量 → 调用 CharMove.AddMovementInput → CharacterMovementComponent 处理实际移动

## 用例

| 引用方 | 路径 | 用途 |
|--------|------|------|
| BP_TestChar | `/Game/Blueprints/BP_TestChar` | 作为端点组件添加到角色，执行移动指令 |
| BP_NewChar | `/Game/Blueprints/BP_NewChar` | 引用该组件处理角色移动输入 |