用途:在 Unity 6.3 LTS 中通过 Input System 包(com.unity.inputsystem 1.x)接入玩家输入,采用基于动作、设备无关、可重建绑定的方式,替代旧的 Input.GetAxis/Input.GetKey。适用于设置移动/跳跃/开火输入、定义含动作映射与控制方案的 .inputactions 资源、接入 PlayerInput 组件、读取 Vector2 摇杆或 WASD 值,以及用同一套动作处理手柄、键盘和触摸。当 Packages/manifest.json 含 com.unity.inputsystem 或项目含 *.inputactions 资源时使用。
主要能力与使用方式:先在 Project Settings → Player 检查 Active Input Handling,需设为 Input System Package (New) 或 Both(保留旧代码时用 Both)。创建 .inputactions 资源,添加动作映射(如 Gameplay)与动作(Move = Value/Vector2,Jump/Fire = Button),绑定控制与复合绑定(WASD 用 2D Vector 复合)。读取方式二选一:PlayerInput 组件,挂到玩家对象、指定资源、选择 Behavior(Send Messages/Broadcast/Invoke Unity Events/Invoke C# Events),适合单人或本地合作;或代码直接读取(InputActionReference/InputActionAsset),需自行 Enable() 动作并在销毁时 Disable()。按上下文切换动作映射(gameplay 与 UI/菜单)而非到处加判断。用 Input Debugger(Window → Analysis → Input Debugger)验证设备与动作触发。
限制与注意:无输入时先查 Active Input Handling 是否为旧模式,或动作/映射未 Enable(PlayerInput 会自动启用,裸 InputAction 不会)。旧后端 InvalidOperationException 说明仍有脚本调用 Input.GetAxis/GetKey。按钮用 ReadValue 会读为 0,应使用 performed 回调或 WasPressedThisFrame()。Send Messages 处理器需与 PlayerInput 同一 GameObject。订阅需在 OnDisable 中 -=,避免重复绑定。触摸/手柄未检测到时启用对应控制方案并在调试器确认设备。交互式重建绑定、JSON 存取绑定与 PlayerInputManager 本地多人见 references/rebinding.md;官方文档为 Unity Manual “Input System”。