游戏引擎 / 系统课时

配置输入与动作映射

配置输入与动作映射

这一节把键盘输入从“按键直连角色”整理为 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 的蓝图初始化逻辑中完成以下连接:

  1. 在 BeginPlay 或本地玩家准备完成的时机取得 Player Controller。
  2. 取得该玩家的 Enhanced Input Local Player Subsystem。
  3. 调用 Add Mapping Context,Mapping Context 选择 IMC_Default,Priority 先设为 0。
  4. 若后续进入载具或 UI 模式,再按状态添加或移除其他 Context,不要把所有按键永久塞进同一个 Context。

Enhanced Input 从按键到角色动作的数据链路

这条链路里,按键属于设备层,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 提供的键输入模拟命令测试映射。

text
Input.+key W
Input.-key W
Input.+key E
Input.-key E

预期结果

text
W 的按下与释放会触发映射到 W 的移动动作;E 的按下与释放会触发交互动作。角色是否实际移动或产生交互效果,取决于对应 Input Action 事件已经连接到角色逻辑。

如果 Input Action 完全没有事件,优先检查 IMC_Default 是否已加入本地玩家子系统;如果事件有值但角色不动,检查 Pawn 是否被正确 Possess,以及 IA_Move 的 X/Y 是否接反。只有某一个方向异常时,再回到 Mapping Context 检查 Negate 与 Swizzle Input Axis Values,比直接修改角色移动逻辑更容易定位问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置输入与动作映射

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通