必须启用Enhanced Input插件，通过UEnhancedInputComponent::BindAction绑定输入，Action与Mapping Context需声明为UPROPERTY并正确关联，按触发时机选Triggered/Started/Ongoing/Completed重载，动态切换用多套Context或PauseBinding。
怎么在C++类里注册Enhanced Input的Input Action和Input Mapping Context
必须先确保项目已启用Enhanced Input插件（Project Settings → Plugins → Enhanced Input → Enabled），否则UEnhancedInputComponent根本不可用，编译会报错找不到类型。
绑定输入的核心是拿到Actor或PlayerController上的UEnhancedInputComponent，然后调用BindAction。但这个组件默认不自动创建，得手动获取或添加：
- 在
APlayerController子类中：重写SetupInputComponent()，先调用父类，再用Cast<uenhancedinputcomponent>(InputComponent)</uenhancedinputcomponent>强转 - 在
AActor子类中（如角色）：需在BeginPlay()里通过GetLocalPlayer()->GetSubsystem<uenhancedinputlocalplayersubsystem>()</uenhancedinputlocalplayersubsystem>获取子系统，再调用AddMappingContext()激活上下文 -
UInputAction和UInputMappingContext资源必须是C++中声明的UPROPERTY()，且加BlueprintReadWrite或VisibleAnywhere，否则蓝图无法引用，C++也无法加载
BindAction参数选哪个重载？Triggered、Started、Ongoing还是Completed
四个重载对应不同触发时机，不是随便选——选错会导致逻辑只执行一次、漏响应、或重复触发。比如跳跃用Triggered，瞄准用Started/Completed配对，右摇杆移动必须用Ongoing才能持续读取轴值。
常见误用：BindAction(MyAction, ETriggerEvent::Completed, this, &AMyCharacter::OnAimReleased)绑了Released却没绑Started，结果松手时函数被调用但没状态记录；或者把移动轴绑成Triggered，导致只读第一帧值。
立即学习“C++免费学习笔记（深入）”；
-
Triggered：按键按下瞬间（单次事件），适合“开火”“切换武器” -
Started：按键刚按住（首次进入持续状态），适合“开始瞄准”“启动冲刺” -
Ongoing：每帧调用，传入FInputActionValue，必须用它读取GetMagnitude()或Get<code>2D()，适合移动、摄像机旋转 -
Completed：按键释放瞬间，适合“停止瞄准”“取消冲刺”
为什么AddMappingContext没反应？Mapping Context里没生效
常见原因不是代码写错，而是Mapping Context没正确关联Input Action，或没在Player Controller生命周期内激活。
AddMappingContext()只是把上下文加入栈，但不会自动启用其中的Action——Action必须已在该Context中显式添加（右键Mapping Context资源 → “Add Input Action”），且该Context未被更高优先级的同名Context覆盖。
- 检查Mapping Context编辑器里
Input Actions列表是否为空；空则右键添加 - 确认
AddMappingContext(MyContext, 0)第二个参数是优先级（int32），数值越大越靠前；如果另一个插件也加了同名Context且优先级更高，你的会被屏蔽 - 在
APlayerController::SetupInputComponent()里加UE_LOG(LogTemp, Warning, TEXT("InputComponent: %s"), *InputComponent->GetClass()->GetName())，确认拿到的是UEnhancedInputComponent而非旧版UInputComponent - 非PlayerController类（如GameMode）不能直接绑定，因为没本地输入权；必须通过PlayerController或Enhanced Input Subsystem转发
如何在C++里动态修改Input Action的触发条件（比如切换为仅PC平台生效）
Enhanced Input本身不支持运行时修改Action的触发规则（如从Pressed改成Axis），但可以通过C++控制绑定逻辑的开关，或切换Mapping Context。
真正灵活的做法是：准备多套UInputMappingContext（如MMC_PC、MMC_Gamepad），在BeginPlay()里根据IsRunningPlatform(PLATFORM_WINDOWS)等判断，只AddMappingContext()对应的一套。
- 避免在Tick里反复
Add/Remove同一Context，性能差且易出竞态 - 若需临时禁用某Action，用
UEnhancedInputComponent::PauseBinding()和ResumeBinding()，比移除Context更轻量 - 注意
FInputActionValue的GetValue()返回值类型取决于Action的EInputActionValueType设置（Vector2D/Float/Boolean），C++里必须匹配，否则Get<code>2D()对Boolean Action会返回零向量
最常被忽略的是：Mapping Context资源必须在项目设置的Default Input Classes里指定为“Default Mapping Context”，否则即使C++加了，编辑器启动时也不会预加载——这会导致打包后首次运行无输入响应。
