新版 Input System 配置入门

🎯本节学习目标

• 理解 Input Actions 结构
• 掌握创建与绑定
• 掌握回调写法

🚀课程导读

新版输入系统用“输入动作资产”把“抽象动作”（移动/跳跃）与“具体按键”（WASD/手柄摇杆）解耦。本课入门。

◆Input Actions 资产

先创建动作资产。

1. 确认已启用 Input System（第 115 课，建议 Both）。
2. 在 Project 右键 → Create → Input Actions，命名 PlayerControls。
3. 双击打开资产编辑窗口（Input Actions Editor）。
4. 【Action Maps 动作映射】左侧可建多个映射：如“Gameplay”“UI”，分别装不同动作。
5. 【Actions 动作】在映射里建动作：右键 → Add Action，如 Move（Vector2 类型）、Jump（Button 类型）。
6. 【Properties】右侧设置动作类型：Value（连续值，如摇杆）、Button（按钮）、Pass-Through。
7. 【Bindings 绑定】选中动作 → 点 + 号添加绑定：如 Move 绑定 WASD/摇杆（自动有 Keyboard 和 Gamepad 默认模板）。
8. 保存资产（Ctrl+S）。

◆代码中读取输入

用 PlayerInput 或生成类。

1. 【方式1 PlayerInput 组件】给对象加 PlayerInput 组件，资产选 PlayerControls，默认行为模式设“Invoke Unity Events”。
2. 在资产编辑器里给动作添加“响应行为”（Response Behavior）：在动作上右键 → Add Binding… 复杂，官方推荐生成 C# 类。
3. 【方式2 生成 C# 类（推荐）】在资产编辑器右上角点【Generate C# Class】，勾选，保存后生成 PlayerControls.cs。
4. 然后在脚本里：
5. PlayerControls controls;
6. void Awake() { controls = new PlayerControls(); }
7. void OnEnable() { controls.Gameplay.Enable(); }
8. void OnDisable() { controls.Gameplay.Disable(); }
9. 读取移动：Vector2 move = controls.Gameplay.Move.ReadValue<Vector2>();
10. 跳跃事件：controls.Gameplay.Jump.performed += ctx => Jump();
11. 【要点】Enable/Disable 控制映射生效；performed 在按下瞬间回调。
12. 【进阶】还可以用 SetBindingOverride 改键（运行时改键）。

⚠常见错误与排查

★动手练习

✓本节小结

新版输入已入门。下一课实现完整的角色移动脚本。