Unity Input System核心：Input Action架构、类型与实战应用详解

1. 项目概述：为什么Input Action是Unity Input System的灵魂

如果你是从Unity的旧Input Manager（就是那个在Input.GetAxis和Input.GetKey里打转的系统）迁移过来的，或者刚接触Unity输入处理，第一次看到Input System的“Input Action”这个概念，可能会有点懵。这不就是个“动作”吗？和直接读手柄摇杆有什么区别？

区别大了。这就像从手动挡换到了自动挡，甚至是从自己造车换到了开一辆高度智能的电动车。旧Input Manager是“设备驱动”的：你的代码直接问“Gamepad的A键按下了吗？”。而Input System，尤其是Input Action，是“意图驱动”的。你的代码不再关心具体是哪个物理按键，而是关心玩家“跳跃”这个意图是否被触发。Input Action就是这个“意图”的抽象载体，它是连接玩家操作（物理输入）和你游戏逻辑（响应函数）之间的桥梁和翻译官。

我刚开始用的时候也觉得多此一举，但踩过几个坑、做完几个跨平台项目后，才发现这玩意儿是真香。它把输入配置从代码里剥离出来，变成了可编辑、可复用、可动态切换的数据资产。这意味着，策划可以不用打扰程序员，自己调整按键映射；支持多手柄、键鼠无缝切换变得异常简单；为残障玩家提供辅助功能（比如把需要快速连按的动作映射到按住一个键）也成了可能。这一切的核心，都始于你如何理解和运用Input Action。

2. Input Action核心概念深度拆解

2.1 Input Action的三层架构：Asset， Map与Action

很多人一上来就直奔InputAction类，但其实理解它的层级关系更重要。Input System的输入管理是三层结构，像一本书的目录：

1. InputActionAsset (.inputactions 文件)：这是最顶层，一个.asset文件，可以理解为你的“输入配置百科全书”。你在Project窗口里右键创建的那个“Input Actions”文件就是它。它包含了下面所有的Map和Action定义，是一个可序列化的ScriptableObject，方便团队管理和版本控制。

2. InputActionMap (动作地图)：Asset里面的一个章节。它是一组逻辑上相关的Input Action的集合。为什么需要分组？想象一下你的游戏有“游戏内操控”、“UI菜单导航”、“拍照模式”三种完全不同的输入上下文。你不会希望按跳跃键时角色没反应，反而把菜单光标移动了。所以，你会创建三个Map，比如Gameplay、UI、PhotoMode，在同一时间只启用其中一个。这比去单独禁用几十个Action要高效和清晰得多。

3. InputAction (动作)：Map里的具体条目，也就是我们最常打交道的对象。它代表一个具体的玩家意图，比如“Move”（移动）、“Jump”（跳跃）、“Fire”（开火）。每个Action有自己的名字、类型、绑定（Bindings）和交互（Interactions）。

在代码中，你可以通过点操作符链式访问：myInputActionAsset.GameplayMap.JumpAction。这种结构强迫你进行逻辑分组，对于管理复杂游戏的输入是至关重要的设计。

2.2 Action的三种类型：Value, Button, Pass-Through

创建Action时第一个要做的选择就是类型（Type）。这个选择直接影响Input System处理输入数据的方式，选错了会导致行为诡异。

Value (值类型)这是默认类型，也是最常用的一种，用于处理连续变化的模拟输入。

• 工作原理：它持续监听所有绑定到它的控件（比如左摇杆和WASD键）。系统会实时评估所有控件的“驱动值”（Actuation Level），并选择“驱动程度最高”的那个控件作为当前输入源，将其值传递给回调。这个过程叫“消歧（Disambiguation）”。比如，你同时轻推了摇杆和按下了W键，系统会判断哪个输入更“强烈”，然后只采用那个输入。
• 关键特性：启用时进行初始状态检查。如果Action启用（Enable()）的那一刻，某个已绑定的控件（比如摇杆）已经处于被推动的状态（哪怕是因为你手一直放在上面），它会立即触发一次performed回调，并读出当前值。这对于移动角色来说通常是期望行为——角色应该立即开始移动。
• 适用场景：角色移动（摇杆/键盘）、相机视角控制（鼠标/摇杆）、车辆转向等任何需要模拟量（Vector2, float）的连续控制。

Button (按钮类型)专为离散的、按钮式输入设计，只能绑定到ButtonControl控件（如各种按键、鼠标点击）。

• 与Value类型的核心区别：没有启用时的初始状态检查。这是为了避免一个经典陷阱：假设你有一个“发射”按钮，在场景切换或角色重生时Action被重新启用。如果玩家一直按住发射键，一个Value类型的Action会立即触发“发射”，这通常不是我们想要的。Button类型避免了这个问题，它只响应启用之后的状态变化。
• 工作原理：虽然也进行消歧，但逻辑更贴合按钮。它非常适合处理“按下即触发”的事件。
• 适用场景：跳跃、开火、互动、打开菜单等瞬发命令。

Pass-Through (直通类型)这是最“放任”的类型，它完全绕过消歧机制。

• 工作原理：任何绑定到它的控件状态发生变化，都会立即触发回调，并带上该控件的值。它没有“主控控件”的概念，所有绑定控件平等地、独立地驱动Action。
• 适用场景：需要同时收集多个输入源的场景，比如：
  • 调试工具：同时监听所有按键，记录输入日志。
  • 输入组合检测（在更高层逻辑处理）：例如，你想自己写代码检测“Shift+W”同时按下，可以把Shift和W都绑定到同一个Pass-Through Action上，每次按键都会触发回调，你再在回调里判断组合状态。
  • 模拟输入直接穿透：将多个摇杆的值不经处理直接传递给某个系统。

注意：使用Pass-Through要非常小心。因为它会响应所有变化，回调触发频率可能极高（比如鼠标移动），容易造成性能问题或逻辑混乱。除非有明确需求，否则优先使用Value或Button。

2.3 理解Action的相位（Phase）与回调

一个Action的生命周期由相位（Phase）描述，这是理解其何时触发回调的关键。

• Disabled：动作未启用，不监听任何输入。
• Waiting：动作已启用，正在等待符合条件的输入。
• Started：一个交互（Interaction）已经开始。例如，按下按钮（开始按压交互）、摇杆偏移超过死区。
• Performed：一个交互已经完成。例如，按钮点击（快速按下并释放）、长按达到规定时间、多次点击完成。
• Canceled：一个交互被取消。例如，在长按完成前松开了按钮、在多次点击序列超时前没有继续点击。

对应的三个核心回调是：

• action.started += callback;
• action.performed += callback;
• action.canceled += callback;

每个回调都会收到一个InputAction.CallbackContext（上下文）对象，这是你获取本次触发详细信息的宝库：

• context.ReadValue<T>()：读取触发此次回调的输入值（如Vector2,float）。这是最常用的方法。
• context.control：获取触发此次回调的具体控件对象（如Gamepad.buttonSouth）。
• context.phase：获取当前回调对应的相位。
• context.interaction：获取触发此次回调的交互对象。

一个经典误区：不是每个动作都一定会经历started和canceled。对于没有设置复杂交互（如Tap,Hold）的简单按钮绑定，通常你只会收到performed（按下时）和canceled（释放时）。started在简单按下时可能瞬间过渡，你捕捉不到。而对于一个Value类型的摇杆移动，你可能会在摇杆推动时收到started，在移动过程中持续收到performed（值持续变化），在摇杆回中时收到canceled。

3. 创建与配置Input Action的四种方式

3.1 可视化编辑器（.inputactions Asset）—— 推荐首选

这是最直观、最高效的方式，尤其适合策划、设计师和快速原型开发。

1. 创建：在Project窗口右键 -> Create -> Input Actions。
2. 编辑：双击该文件，会打开专用的Input Action编辑器窗口。
3. 核心操作：
   • 创建Action Map：点击"+"号，例如创建Player。
   • 创建Action：在Map下点击"+"号，命名（如Move），选择类型（如Value， Vector2）。
   • 添加绑定（Binding）：点击Action下的"+"号。这是关键步骤。你可以在右侧的Path处点击搜索图标，通过设备图形界面选择（如Gamepad->Left Stick），也可以直接输入路径文本（如<Gamepad>/leftStick）。
   • 设置交互（Interaction）与处理器（Processor）：在绑定列表的每一行，可以展开Interactions和Processors进行添加。例如，为摇杆添加一个Stick Deadzone处理器，为射击添加一个Hold交互。

可视化编辑器的优势：

• 非程序员友好：所有配置可视化，无需写代码。
• 复用与共享：.inputactions文件是项目资产，易于团队共享和版本管理。
• 运行时重绑定：系统内置支持读取这个资产结构，便于实现玩家自定义按键。

3.2 在MonoBehaviour中嵌入字段

你可以将InputAction或InputActionMap作为public字段直接声明在MonoBehaviour脚本中。在Inspector窗口中，它们会呈现为一个微型的可视化编辑器。

public class PlayerController : MonoBehaviour { public InputAction moveAction; public InputAction jumpAction; public InputActionMap uiActions; private void OnEnable() { moveAction.Enable(); jumpAction.Enable(); uiActions.Enable(); } private void OnDisable() { moveAction.Disable(); jumpAction.Disable(); uiActions.Disable(); } private void Start() { jumpAction.performed += ctx => OnJump(); } void OnJump() { /* 跳跃逻辑 */ } }

在Inspector里，你可以点击字段右边的齿轮图标或直接展开来配置绑定、交互等，就像在Asset编辑器里一样。这种方式适合小型、局部的输入配置，或者当你希望输入逻辑紧密耦合在某个特定组件上时。

重要注意事项：

• 必须手动启用/禁用：与Asset方式不同，嵌入字段的Action不会自动启用。你必须在OnEnable中调用Enable()，在OnDisable中调用Disable()，否则它不会响应输入。这是新手最常见的坑之一。
• 序列化：配置信息会直接序列化保存在Prefab或场景中的该组件上，而不是独立的资产文件。

3.3 通过JSON动态加载

Input Action系统支持从JSON字符串创建InputActionMap或完整的InputActionAsset。这为实现网络下载自定义按键配置、玩家分享配置等高级功能提供了可能。

string jsonConfig = @" { ""maps"": [ { ""name"": ""Gameplay"", ""actions"": [ { ""name"": ""Fire"", ""type"": ""Button"", ""bindings"": [ { ""path"": ""<Mouse>/leftButton"" } ] } ] } ] }"; // 加载一组Action Map InputActionMap[] maps = InputActionMap.FromJson(jsonConfig); // 或者加载整个Asset InputActionAsset asset = InputActionAsset.FromJson(jsonConfig); // 启用并使用 maps[0].Enable();

JSON的结构与你可视化编辑后保存的.inputactions文件内容是一致的。你可以通过编程方式生成或修改这个JSON字符串。

3.4 纯代码创建

终极灵活度，完全在运行时用代码构建输入系统。

// 1. 创建独立的Action InputAction moveAction = new InputAction("Move", type: InputActionType.Value); moveAction.AddBinding("<Gamepad>/leftStick"); // 添加复合绑定（Composite Binding）：将多个物理控件组合成一个逻辑输入 moveAction.AddCompositeBinding("2DVector") // 使用2D向量复合类型 .With("Up", "<Keyboard>/w") .With("Down", "<Keyboard>/s") .With("Left", "<Keyboard>/a") .With("Right", "<Keyboard>/d"); // 2. 创建Action Map并添加Action InputActionMap gameplayMap = new InputActionMap("Gameplay"); InputAction jumpAction = gameplayMap.AddAction("Jump", type: InputActionType.Button); jumpAction.AddBinding("<Gamepad>/buttonSouth"); jumpAction.AddBinding("<Keyboard>/space"); // 3. 创建Asset并添加Map（可选，用于更复杂的管理） InputActionAsset myAsset = ScriptableObject.CreateInstance<InputActionAsset>(); myAsset.AddActionMap(gameplayMap); // 启用 moveAction.Enable(); gameplayMap.Enable();

代码创建的适用场景：

• 需要根据游戏状态动态生成输入配置（如技能树解锁新按键）。
• 开发插件或框架，不希望依赖外部.inputactions资产。
• 极简项目，觉得可视化编辑器杀鸡用牛刀。

实操心得：对于大多数项目，强烈推荐使用可视化编辑器（.inputactions Asset）。它清晰、可维护、非程序员可参与。将代码创建作为备用方案，仅在确有动态需求时使用。MonoBehaviour嵌入方式则适合UI控件等简单、独立的输入需求。

4. 使用Input Action：响应输入的多种模式

创建好Action之后，下一步就是让游戏逻辑响应它。Input System提供了多种响应模式，适应不同场景。

4.1 回调函数模式（Callback）—— 事件驱动

这是最常用、最直观的方式，为Action的started,performed,canceled事件添加监听器。

public InputAction moveAction; public InputAction jumpAction; private Vector2 moveInput; private void OnEnable() { moveAction.Enable(); jumpAction.Enable(); // 方式1：Lambda表达式，适合简单逻辑 jumpAction.performed += ctx => { Debug.Log("Jump triggered!"); GetComponent<Rigidbody>().AddForce(Vector3.up * 5f, ForceMode.Impulse); }; // 方式2：委托给已定义的方法，适合复杂逻辑 moveAction.performed += OnMovePerformed; moveAction.canceled += OnMoveCanceled; } private void OnDisable() { moveAction.Disable(); jumpAction.Disable(); // 重要：取消订阅，防止内存泄漏！ moveAction.performed -= OnMovePerformed; moveAction.canceled -= OnMoveCanceled; } private void OnMovePerformed(InputAction.CallbackContext context) { // 持续读取摇杆或键盘输入的值 moveInput = context.ReadValue<Vector2>(); } private void OnMoveCanceled(InputAction.CallbackContext context) { // 输入停止，例如摇杆回中 moveInput = Vector2.zero; } private void Update() { // 在Update中使用moveInput驱动角色移动 Vector3 movement = new Vector3(moveInput.x, 0, moveInput.y); transform.Translate(movement * speed * Time.deltaTime); }

关键点：

• 启用是必须的：再次强调，Enable()是起点。
• 及时取消订阅：在OnDisable或对象销毁时，务必取消事件订阅，否则回调对象无法被垃圾回收，导致内存泄漏。如果Action生命周期与组件一致（都在OnEnable/OnDisable中管理），则可以不取消，但显式取消是好习惯。
• CallbackContext的生命周期：ctx对象仅在回调函数执行期间有效。不要存储它供以后使用。如果需要存储数据，用ctx.ReadValue<T>()读出来存到自己的变量里。

4.2 轮询模式（Polling）—— 状态查询

有些时候，特别是在Update循环中需要持续获取输入状态（比如移动），使用轮询模式更直接。你不需要设置回调，而是直接在需要的地方读取当前值。

public InputAction moveAction; public float speed = 5f; private void OnEnable() { moveAction.Enable(); } private void OnDisable() { moveAction.Disable(); } private void Update() { // 直接读取Action当前的值 Vector2 direction = moveAction.ReadValue<Vector2>(); Vector3 movement = new Vector3(direction.x, 0, direction.y); transform.Translate(movement * speed * Time.deltaTime); // 对于按钮，可以使用 triggered 属性 if (jumpAction.triggered) // 如果在本帧内按钮被“触发”（通常指按下） { Jump(); } }

ReadValue<T>()vstriggered：

• ReadValue<T>()：返回Action当前驱动控件的瞬时值。对于Value类型，这是连续的；对于Button类型，这是一个浮点数（0或1，或模拟扳机的0到1）。
• triggered：一个布尔值，表示在本帧内，Action是否进入了performed阶段。它非常适合用于需要每帧检测一次瞬发动作的场景，比如射击。注意，它只在performed发生的那一帧返回true。

模式选择建议：

• 连续输入（移动、视角）：在Update中使用轮询ReadValue更简单。
• 离散事件（跳跃、交互、开火）：使用回调performed更准确，能确保不错过任何一次触发，且能方便地区分started、performed、canceled。
• 混合使用：完全可以在一个项目中同时使用两种模式。例如，用回调处理跳跃，用轮询处理移动。

4.3 通过InputActionMap统一监听

如果你有很多Action，不想为每一个都单独写订阅代码，可以监听整个Action Map的actionTriggered事件。

public InputActionMap gameplayActions; private void OnEnable() { gameplayActions.Enable(); gameplayActions.actionTriggered += OnGameplayActionTriggered; } private void OnDisable() { gameplayActions.Disable(); gameplayActions.actionTriggered -= OnGameplayActionTriggered; } private void OnGameplayActionTriggered(InputAction.CallbackContext context) { string actionName = context.action.name; switch (actionName) { case "Jump": if (context.performed) Jump(); break; case "Fire": if (context.started) StartCharging(); else if (context.canceled) ReleaseFire(); break; case "Move": // 对于持续移动，这里可能不是最佳位置，更适合轮询 break; } }

这种方式将输入处理逻辑集中到了一处，管理起来可能更清晰，但也可能让这个函数变得非常庞大。它同样会收到所有Action的started,performed,canceled事件。

4.4 使用InputActionTrace进行调试记录

InputActionTrace是一个强大的调试工具，它可以记录所有发生在Action上的活动，像一个输入日志记录器。

private InputActionTrace trace; void Start() { trace = new InputActionTrace(); // 需要 using UnityEngine.InputSystem.Utilities; trace.SubscribeTo(myAction); // 订阅单个Action // trace.SubscribeToAll(); // 订阅所有Action！小心性能 } void Update() { // 定期或在需要时输出记录 foreach (var record in trace) { Debug.Log($"[{record.time}] {record.action.name} - {record.phase} by {record.control.name} Value: {record.ReadValueAsObject()}"); } trace.Clear(); // 清空记录，避免无限增长 } void OnDestroy() { trace?.Dispose(); // 非常重要！释放非托管内存 }

这在排查“为什么我的Action没触发”或“输入顺序不对”的问题时非常有用。你可以看到精确到每一帧的输入事件流。

5. 高级特性与实战技巧

5.1 复合绑定（Composite Bindings）：将多个键映射为一个向量

这是Input System一个非常优雅的设计，用于处理像WASD控制移动这样的经典需求。你不再需要自己写代码将四个独立的按键组合成一个方向向量。

在可视化编辑器中，为Action（如Move，类型Value， 值类型Vector2）添加绑定时，选择“Add Composite”。常用的有：

• 2D Vector：上下左右四个方向。你可以为Up绑定W/上箭头，Down绑定S/下箭头等。
• 1D Axis：一个正负轴。例如，绑定A为负向，D为正向，用于水平移动。
• Button With One Modifier：需要组合键，如Ctrl+C。

在代码中，使用AddCompositeBinding：

moveAction.AddCompositeBinding("2DVector") .With("Up", "<Keyboard>/w") .With("Down", "<Keyboard>/s") .With("Left", "<Keyboard>/a") .With("Right", "<Keyboard>/d");

系统会自动处理这些按键的按下/抬起状态，并合成一个标准化的Vector2输出给ReadValue<Vector2>()，极大简化了代码。

5.2 交互（Interactions）与处理器（Processors）

这是Input Action系统的“魔法”部分，它们定义了原始输入信号如何被解释成有意义的游戏动作。

交互（Interactions）：定义输入的“模式”或“手势”。

• Press：默认交互。区分按下（started）、按住（performed可能多次触发，取决于设置）、释放（canceled）。
• Hold：长按。按下后持续一段时间才触发performed，提前释放触发canceled。
• Tap：点击。快速按下并释放。
• SlowTap：慢速点击。
• MultiTap：多次点击（如双击、三连击）。
• Scale：根据按压时间缩放值（常用于模拟扳机压力）。

你可以在可视化编辑器的绑定详情里添加交互，并配置参数（如Hold Time）。在代码中，可以在添加绑定时通过字符串指定：

jumpAction.AddBinding("<Keyboard>/space", interactions: "tap,slowTap(duration=0.5)");

处理器（Processors）：对读取到的输入值进行加工。

• Invert：反转值（例如，反转Y轴）。
• Normalize：标准化向量（确保最大长度为1）。
• Scale：缩放值。
• Stick Deadzone：为摇杆设置死区，忽略中心的微小抖动。这是必选项，能极大提升操作手感。
• Axis Deadzone：为1D轴设置死区。

处理器也在绑定详情中添加。例如，为摇杆添加一个Stick Deadzone处理器，并设置min和max值。

实操心得：善用交互可以做出非常细腻的操作手感。例如，将“射击”绑定到鼠标左键，并添加一个Hold交互，设置pressPoint=0.5（半按触发started开始蓄力），duration=1.0（按住1秒触发performed满力射击），releasePoint=0（释放触发canceled取消射击）。这样，一个简单的按键就实现了“轻按速射、长按蓄力”的复杂逻辑，而你的回调代码只需要根据started,performed,canceled做出相应反应即可。

5.3 控件方案（Control Schemes）与设备过滤

Control Schemes允许你为同一组Action定义多套绑定方案，并在运行时动态切换。最常见的用途是区分“键鼠”和“手柄”两套操作方式。

1. 在编辑器中创建：在Input Action Asset的编辑窗口，你可以创建多个Control Scheme（如KeyboardMouse,Gamepad）。
2. 为绑定指定方案：在添加绑定时，可以在右侧选择该绑定属于哪个Control Scheme。例如，将WASD绑定到KeyboardMouse方案，将左摇杆绑定到Gamepad方案。
3. 在运行时启用/禁用方案：你可以通过代码激活特定方案，系统会自动启用该方案下的所有绑定，并禁用其他方案的绑定。

   // 获取Asset中的某个方案 InputActionAsset asset = myInputActionAsset; // 方法1：通过名字获取 InputControlScheme scheme = asset.controlSchemes.FirstOrDefault(s => s.name == "Gamepad"); // 方法2：使用PlayerInput组件（更简单，见下文）自动处理

   更常见的做法是使用PlayerInput组件，它会自动检测当前活动的设备并切换到匹配的Control Scheme。

设备过滤：在绑定路径中，你可以使用设备限定符。例如，<Gamepad>/buttonSouth只匹配游戏手柄，<Mouse>/leftButton只匹配鼠标。当使用Control Schemes时，系统会自动根据方案关联的设备类型来启用/禁用绑定。

6. 常见问题排查与性能优化

6.1 为什么我的Action没有触发？

这是新手最常遇到的问题，按以下清单排查：

1. 是否启用了Action？：检查代码中是否调用了action.Enable()或actionMap.Enable()。对于嵌入MonoBehaviour的字段，是否在OnEnable中启用？
2. 设备连接了吗？：检查Input Debugger（Window -> Analysis -> Input Debugger）确认目标设备（如游戏手柄）是否被识别并处于connected状态。
3. 绑定路径正确吗？：检查绑定的控件路径是否有拼写错误。在Input Debugger中选中设备，查看其准确的控件路径。
4. 有多个玩家输入冲突吗？：如果使用了PlayerInput组件且配置了多玩家，检查输入是否被错误的玩家实例捕获了。确保PlayerInput的Behavior设置正确。
5. Action被禁用或覆盖了吗？：检查是否有其他代码或组件（如另一个Action Map）禁用了这个Action。
6. 交互设置是否过于严格？：例如，设置了Hold交互但按住时间不够长，performed就不会触发。检查交互参数。
7. 回调函数订阅了吗？：确认performed等事件已经正确添加了监听器。
8. 在正确的更新模式中吗？：检查Edit -> Project Settings -> Input System Package -> Update Mode。如果是Fixed Update，你的Update函数里可能读不到输入。确保轮询或处理输入的代码与更新模式匹配。

6.2 输入延迟或响应不跟手

1. 更新模式（Update Mode）：默认是Dynamic Update，它会在MonoBehaviour.Update后、MonoBehaviour.LateUpdate前处理输入，对于大多数情况是合适的。对于要求极高响应速度的竞技游戏，可以考虑Process Events In Fixed Update（与物理更新同步），但这需要你的游戏逻辑也主要在FixedUpdate中运行，否则可能产生帧间不一致。
2. 事件合并：Input System默认会合并短时间内连续的鼠标移动等事件。如果不需要，可以尝试调整相关设置（但通常不建议修改）。
3. 过多的全局监听：InputSystem.onActionChange或订阅了过多Action的全局回调，如果其中包含复杂的逻辑，可能拖慢整体输入处理。优化回调函数内的代码。
4. 使用InputActionTrace未及时清理：InputActionTrace会记录所有事件，如果不定期Clear()或Dispose()，会积累大量数据影响性能。仅在调试时使用，发布时移除。

6.3 多设备输入冲突与玩家输入管理

当支持多个手柄本地同屏游戏时，需要管理哪个手柄控制哪个玩家。这是PlayerInputManager组件和PlayerInput组件的职责。

• PlayerInputManager：负责监听新设备的加入，并实例化玩家预制体。
• PlayerInput：附加在每个玩家预制体上，负责将具体的输入Action Asset映射到该玩家，并处理设备分配。

常见配置步骤：

1. 在游戏管理器物体上添加PlayerInputManager，设置玩家预制体。
2. 在玩家预制体上添加PlayerInput，并分配你的.inputactionsAsset。
3. 在PlayerInput中，将Behavior设置为Send Messages或Invoke Unity Events，并关联你的处理函数。
4. 确保你的Input Action Asset中定义了Control Schemes（如Gamepad）。
5. 运行游戏，按下手柄上的按钮，PlayerInputManager会自动实例化新玩家，并将该手柄分配给对应玩家的PlayerInput。

避坑技巧：如果出现设备“抢控”问题（一个手柄操作了所有玩家），检查PlayerInput的Input Action Asset是否各自独立，以及Control Scheme是否设置正确。确保每个玩家的PlayerInput组件是独立的。

6.4 输入值读取的常见坑

1. 读取错误的值类型：用ReadValue<Vector2>()去读一个按钮，会返回default(Vector2)即(0,0)。确保你读取的类型与Action绑定控件的值类型匹配。在可视化编辑器中创建Action时设置的正确Value Type（如Button对应float，Stick对应Vector2）能提供编译时检查。
2. 在canceled回调中读取值：对于按钮，canceled（释放）时读取的值通常是0。这是符合预期的。如果你需要知道释放前的值，需要在performed时存储它。
3. 复合绑定的方向不对：使用WASD复合绑定时，默认Up是(0,1)，即世界空间的Z轴正方向。如果你的角色移动朝向不同，需要在代码中对读取到的Vector2进行旋转或映射。

掌握Input Action，就掌握了Unity Input System的精髓。它初看复杂，但一旦理解其“意图驱动”的设计哲学和分层结构，你就会发现它带来的清晰度、可维护性和灵活性，远非旧输入系统可比。从今天起，尝试在你的下一个项目或原型中完全使用Input System和Input Action来管理输入，亲自体验这种现代化输入管理方式带来的效率提升。