用途:在 UE5 中以现代 Enhanced Input 系统接入玩家输入,用数据驱动的 Input Action(IA_)与 Input Mapping Context(IMC_)替代旧版 Project Settings 的轴/动作映射。适用于添加移动、视角、跳跃、开火输入,创建 IA_/IMC_ 资产,应用修饰器与触发器,为玩家添加映射上下文,或在 C++、蓝图中绑定动作;目标版本为 UE 5.8,旧输入系统已弃用。
主要能力:定义动作值类型(Digital 布尔、Axis1D 浮点、Axis2D 二维向量);用 Modifier 塑形原始输入(Negate、Swizzle Input Axis Values、Dead Zone);用 Trigger(Pressed、Hold、Tap)控制触发时机;通过 EnhancedInputLocalPlayerSubsystem 的 AddMappingContext(IMC, Priority) 加载上下文;在 EnhancedInputComponent 上按 ETriggerEvent 绑定并在回调中读取 FInputActionValue。
用法要点:UE5 默认启用该插件;C++ 绑定需在 *.Build.cs 的 PublicDependencyModuleNames 加入 "EnhancedInput"。通常在 BeginPlay 或获得控制权后调用 AddMappingContext。可用控制台 showdebug enhancedinput 在 PIE 中验证。
限制与注意:上下文未添加或尚无 Local Player 会导致无输入;缺少 Build.cs 模块会引起链接/编译错误;Axis2D 的 WASD 需要在负向键加 Negate、纵向键加 Swizzle,否则轴错乱;Get<FVector2D>() 返回零通常是值类型不匹配;Triggered 在按住时会持续触发,单次动作用 Started/Completed 或 Pressed/Tap;多个 IMC 按优先级叠加,高优先级可消费按键,需用优先级与 RemoveMappingContext 管理。