游戏引擎 / 系统课时
配置输入与动作映射
配置输入与动作映射
这一节把键盘输入从“按键直连角色”整理为 Enhanced Input 的动作链路。完成后,WASD、跳跃和交互分别进入独立 Input Action,由同一 Mapping Context 统一映射,为后续切换载具或菜单输入留下清晰边界。
学习目标
- 创建移动、跳跃和交互所需的 Input Action,并选择正确的 Value Type。
- 用 Input Mapping Context 把物理按键映射到动作,并理解 Modifier 的作用。
- 在本地玩家上启用 Mapping Context,绑定事件并在 PIE 中验证输入链路。
先把动作和按键分开
Enhanced Input 的关键是把“玩家想做什么”和“当前用哪个键触发”分开。先在 Content Drawer 中右键,选择 Input > Input Action,创建 IA_Move、IA_Jump、IA_Interact;再创建一个 Input > Input Mapping Context,命名为 IMC_Default。
| 资产 | Value Type | 用途 |
|---|---|---|
IA_Move |
Axis2D (Vector2D) | 同时表达前后与左右移动 |
IA_Jump |
Digital (Bool) | 表达按下、保持与释放 |
IA_Interact |
Digital (Bool) | 表达一次交互触发 |
在 IMC_Default 中添加映射。约定 X 轴表示左右,Y 轴表示前后时,D 可以直接贡献正 X,A 使用 Negate 得到负 X;W 需要 Swizzle Input Axis Values = YXZ 把单轴输入转到 Y,S 则再叠加 Negate 得到负 Y。Space Bar 映射到 IA_Jump,E 映射到 IA_Interact。
让 Mapping Context 真正生效
创建了 Input Action 和 Mapping Context,并不代表运行时会自动读取它们。对于本地玩家,需要把 IMC_Default 加入 Enhanced Input Local Player Subsystem;优先级越高的 Context 在输入冲突时越优先。
在角色或 Player Controller 的蓝图初始化逻辑中完成以下连接:
- 在
BeginPlay或本地玩家准备完成的时机取得 Player Controller。 - 取得该玩家的 Enhanced Input Local Player Subsystem。
- 调用
Add Mapping Context,Mapping Context 选择IMC_Default,Priority 先设为0。 - 若后续进入载具或 UI 模式,再按状态添加或移除其他 Context,不要把所有按键永久塞进同一个 Context。

这条链路里,按键属于设备层,Mapping Context 决定当前情境下的映射,Input Action 才是游戏逻辑真正依赖的接口。这样以后把跳跃从 Space 改成手柄按钮,只改映射即可,不需要修改跳跃函数。
把动作事件接到角色行为
在角色蓝图中添加三个 Input Action 事件。IA_Move 使用 Triggered,从 Action Value 取出 Vector2D:Y 传给角色 Forward Vector 的 Add Movement Input,X 传给 Right Vector 的 Add Movement Input。这要求当前 Pawn 已被 Player Controller Possess,并且角色使用的 Movement Component 能响应移动输入。
IA_Jump 可以用 Started 调用 Jump,用 Completed 调用 Stop Jumping。IA_Interact 通常用 Started 触发一次交互查询,避免按住 E 时每帧重复执行。
在 PIE 中验证整条链路
先直接按键确认 WASD、Space 和 E 都进入预期行为。需要排除键盘硬件或窗口焦点影响时,可以在 PIE 中打开控制台,用 Enhanced Input 提供的键输入模拟命令测试映射。
Input.+key W
Input.-key W
Input.+key E
Input.-key E预期结果
W 的按下与释放会触发映射到 W 的移动动作;E 的按下与释放会触发交互动作。角色是否实际移动或产生交互效果,取决于对应 Input Action 事件已经连接到角色逻辑。如果 Input Action 完全没有事件,优先检查 IMC_Default 是否已加入本地玩家子系统;如果事件有值但角色不动,检查 Pawn 是否被正确 Possess,以及 IA_Move 的 X/Y 是否接反。只有某一个方向异常时,再回到 Mapping Context 检查 Negate 与 Swizzle Input Axis Values,比直接修改角色移动逻辑更容易定位问题。