1. 项目概述：告别旧Input，拥抱新交互

如果你还在Unity里用Input.GetKeyDown或者Input.GetAxis来写输入逻辑，是时候看看这个新东西了。Unity的Input System，官方钦定的新一代输入管理系统，它带来的不仅仅是API的更新，更是一种更清晰、更强大、也更适合现代游戏（尤其是移动端和跨平台）的输入处理范式。我最近在一个需要同时支持PC键盘、手柄和手机触屏的项目里，被老Input Manager折腾得够呛，彻底转向Input System后，感觉世界都清净了。

这个项目的核心，就是解决两个非常实际的问题：第一，如何让UI按钮（比如一个“跳跃”按钮）不仅能被点击，还能被键盘上的空格键触发？第二，在手机屏幕上，如何快速、优雅地做出一个手感不错的虚拟摇杆，用来控制角色移动？这两个需求看似简单，但用老方法实现，代码容易散乱且难以维护。Input System通过其“Action（动作）”的概念，提供了一套统一的解决方案。简单来说，它让你不再关心“哪个键被按下了”，而是关心“玩家想做什么动作”，比如“跳跃”或“移动”，然后你可以自由地为这个动作绑定键盘、鼠标、手柄甚至触屏手势。接下来，我会带你从零开始，一步步实现这两个功能，并分享我在实战中踩过的坑和总结的技巧。

2. Input System核心概念与项目设置

在动手写代码之前，我们必须先理解Input System的几个核心基石。这能帮你从“照着抄”变成“明白为什么这么写”。

2.1 核心三要素：Action、Action Map与Control Scheme

Input System的架构围绕三个关键概念构建，理解它们的关系至关重要。

1. Action（动作）：这是最核心的概念。它代表玩家在游戏中的一个意图，而不是具体的硬件输入。例如，“跳跃”、“移动”、“攻击”、“打开菜单”都是动作。你只需要在代码里监听“跳跃”这个动作是否被触发，至于这个动作是由空格键、手柄A键还是屏幕上的某个区域触发的，Input System会帮你处理。

2. Action Map（动作映射集）：一组逻辑上相关的Action的集合。通常，我们会按游戏模式来划分Action Map。比如，你可以有一个“Gameplay”映射集，里面包含“移动”、“跳跃”、“攻击”等动作；另一个“UI”映射集，里面包含“确认”、“取消”、“导航”等动作。在不同的游戏状态下（如战斗中、菜单中），你可以启用或禁用不同的Action Map，从而避免输入冲突。

3. Control Scheme（控制方案）：定义了完成一组Action所需的输入设备类型。例如，“键盘鼠标”方案、“游戏手柄”方案、“触屏”方案。一个Action Map可以支持多个Control Scheme。Input System能自动检测当前活跃的设备，并切换到对应的控制方案，这对于实现跨平台输入无缝切换是革命性的。

它们的关系可以这样类比：Action Map像一个功能清单（如“驾驶汽车”清单），Action是清单上的具体项目（如“踩油门”、“打方向盘”），而Control Scheme则是完成这些项目的不同工具手册（如“自动挡手册”、“手动挡手册”）。

2.2 项目导入与初始配置

首先，你需要确保项目已经安装了Input System包。如果你的项目是2019.4或更新版本，推荐通过Package Manager安装。

1. 打开Unity，进入Window -> Package Manager。
2. 在Package Manager窗口左上角，选择Unity Registry。
3. 在列表中找到Input System并点击安装。安装过程中，Unity会提示你禁用旧的Input Manager，建议选择“Yes”，这样会更新项目设置，避免新旧系统冲突。

注意：禁用旧Input Manager后，所有使用Input类的代码都会编译报错。这是预期行为，我们的目标就是迁移它们。

安装完成后，你需要创建一个Input Actions资源文件，这是可视化配置所有输入的地方。

1. 在Project窗口中右键，选择Create -> Input Actions。我通常命名为PlayerControls。
2. 双击这个新创建的.inputactions文件，会打开一个专门的配置编辑器窗口。

3. 创建与配置Input Actions资源

这个可视化编辑器是我们配置所有输入逻辑的主战场。我们来一步步创建实现项目目标所需的配置。

3.1 为UI交互创建Action Map和Action

我们的第一个目标是让UI能响应键盘输入。为此，我们创建一个专门用于UI的Action Map。

1. 在Input Actions编辑器里，点击Action Maps旁边的+号，新建一个Map，命名为UI。
2. 在新建的UIMap下，点击Actions旁边的+号，新建一个Action。命名为Navigate，这个动作将用于UI控件（如按钮、滑块）之间的导航。
3. 将Navigate的Action Type设置为Value，Control Type设置为Vector2。这意味着它将返回一个二维方向值，非常适合用方向键或手柄摇杆在UI元素间移动。
4. 选中NavigateAction，在右边的Bindings面板，点击Path下的Listen按钮，然后按下键盘上的W键。这会自动创建一个绑定，路径类似<Keyboard>/w。同样地，我们再添加S、A、D键的绑定，分别对应上、下、左、右。你也可以直接添加一个<Keyboard>/upArrow等。
5. 继续在UIMap下新建一个Action，命名为Submit（确认），Action Type设置为Button。为其绑定<Keyboard>/enter和<Keyboard>/space。
6. 再新建一个Cancel（取消）Action，类型为Button，绑定<Keyboard>/escape。

现在，你就拥有了一个标准的UI输入映射集。Unity内置的EventSystem和Input System UI Input Module组件能够自动识别这些具有特定名称（如Submit，Cancel，Navigate）的Action，并驱动UI的交互。这就是为什么我们不需要写代码，就能让UI按钮响应回车键和空格键的原因——只要配置对了名字，系统就帮你对接好了。

3.2 为虚拟摇杆与角色控制创建Action

接下来，我们创建控制游戏角色的Action，其中就包括虚拟摇杆要控制的“移动”。

1. 新建一个Action Map，命名为Player。
2. 在PlayerMap下，新建一个Action，命名为Move。这是虚拟摇杆的核心。
   • Action Type:Value
   • Control Type:Vector2。摇杆的输出就是一个二维向量。
3. 为Move添加绑定。对于键盘，我们可以绑定WASD或方向键。但这里有个关键点：虚拟摇杆的输入源不是这些硬件，而是一个我们后面用代码生成的“虚拟设备”。所以，我们暂时只为它添加一个游戏手柄左摇杆的绑定作为参考，路径是<Gamepad>/leftStick。虚拟摇杆的绑定需要在运行时通过代码动态添加。
4. 在PlayerMap下，你还可以添加其他动作，比如Jump（Button类型，绑定空格键）、Attack（Button类型，绑定鼠标左键或手柄X键）等。

配置完成后，记得点击编辑器上方的Save Asset按钮保存。这个.inputactions文件就是一个包含了所有输入定义的数据库。

4. 实现UI控件与键盘输入绑定

配置好了输入资源，接下来就是如何在游戏中使用它。让UI响应键盘，其实大部分工作Unity已经帮我们做好了。

4.1 设置Input System UI Input Module

首先，你需要确保场景中的EventSystem使用的是Input System的模块。

1. 检查你的场景中是否有EventSystem游戏对象。如果没有，Unity通常会在你创建第一个UI元素时自动生成一个。
2. 选中EventSystem对象，查看其Inspector面板。你会看到它挂载了Event System脚本和一个输入模块。
3. 移除默认的Standalone Input Module组件（点击组件右上角的三个点，选择Remove Component）。
4. 点击Add Component，搜索并添加Input System UI Input Module。

至此，UI系统就已经切换为使用Input System来驱动了。它默认会去寻找一个名为UI的Action Map，并使用其中的Submit，Cancel，Navigate等Action。这正是我们之前配置好的。现在运行游戏，选中一个按钮，你应该已经可以使用键盘的方向键进行导航，并用空格或回车键点击按钮了。

4.2 在代码中监听UI相关输入

有时，你可能需要在脚本里直接响应这些UI输入，而不是仅仅依靠Button组件的onClick事件。这时，我们需要在代码中获取并启用我们配置的Input Actions。

首先，创建一个C#脚本，比如叫UIInputHandler。

using UnityEngine; using UnityEngine.InputSystem; public class UIInputHandler : MonoBehaviour { // 引用我们创建的Input Actions资源 public InputActionAsset inputActions; // 声明Input Action引用 private InputAction navigateAction; private InputAction submitAction; private InputAction cancelAction; private void Awake() { // 从资源中找到UI Action Map var uiMap = inputActions.FindActionMap("UI"); if (uiMap == null) { Debug.LogError("未找到名为 'UI' 的Action Map。"); return; } // 获取具体的Action navigateAction = uiMap.FindAction("Navigate"); submitAction = uiMap.FindAction("Submit"); cancelAction = uiMap.FindAction("Cancel"); // 为Action绑定回调函数 submitAction.performed += OnSubmitPerformed; cancelAction.performed += OnCancelPerformed; // Navigate是一个Value Action，通常用.canceled或每帧读取，这里用.started示例 navigateAction.started += OnNavigateStarted; } private void OnEnable() { // 启用这个Action Map及其下的所有Action inputActions.FindActionMap("UI").Enable(); // 或者单独启用Action // navigateAction.Enable(); // submitAction.Enable(); // cancelAction.Enable(); } private void OnDisable() { // 禁用，避免内存泄漏和意外输入 inputActions.FindActionMap("UI").Disable(); submitAction.performed -= OnSubmitPerformed; cancelAction.performed -= OnCancelPerformed; navigateAction.started -= OnNavigateStarted; } private void OnSubmitPerformed(InputAction.CallbackContext context) { Debug.Log("UI确认键被按下"); // 这里可以执行自定义的UI逻辑，例如播放音效 } private void OnCancelPerformed(InputAction.CallbackContext context) { Debug.Log("UI取消键被按下"); // 例如，关闭当前打开的弹窗 } private void OnNavigateStarted(InputAction.CallbackContext context) { Vector2 direction = context.ReadValue<Vector2>(); Debug.Log($"UI导航方向: {direction}"); // 可以根据方向值进行自定义的导航处理 } }

将这个脚本挂载到场景中任意一个持久存在的对象上（如GameManager），并将之前创建的PlayerControls.inputactions资源拖拽到脚本的inputActions字段上。运行游戏，当你按下相应的键盘键时，就能在Console中看到对应的日志。

实操心得：对于纯粹的UI导航（用方向键切换选中按钮），使用内置的Input System UI Input Module就足够了，无需额外脚本。只有当你需要为UI输入添加更复杂的反馈逻辑（比如导航时播放“滴答”声）时，才需要像上面这样在代码中监听。

5. 快速制作虚拟摇杆（Virtual Joystick）

虚拟摇杆是移动平台控制的灵魂。用Input System实现，我们可以让它输出标准的Vector2值，完美对接我们之前创建的MoveAction，实现与键盘、手柄控制逻辑的统一。

5.1 虚拟摇杆UI布局与组件设计

我们使用UGUI来构建摇杆的视觉部分。

1. 在Canvas下创建一个Image作为摇杆的“底座”（Background），命名为JoystickBG。设置一个半透明的圆形Sprite。
2. 在JoystickBG内部再创建一个Image作为“手柄”（Handle），命名为JoystickHandle。设置一个颜色鲜明的圆形Sprite。
3. 为JoystickBG添加一个VirtualJoystick脚本（我们接下来会创建）。同时，为了方便获取组件，我们可以在脚本中声明这些UI元素的引用。

5.2 核心脚本：VirtualJoystick.cs

这个脚本负责处理触屏输入，计算摇杆偏移量，并将结果输出给Input System。

using UnityEngine; using UnityEngine.EventSystems; using UnityEngine.InputSystem; using UnityEngine.UI; [RequireComponent(typeof(RectTransform), typeof(Image))] public class VirtualJoystick : MonoBehaviour, IPointerDownHandler, IDragHandler, IPointerUpHandler { [Header("UI References")] [SerializeField] private RectTransform handle; // 摇杆手柄 [SerializeField] private Image backgroundImage; // 摇杆底座背景（可选，用于视觉反馈） [Header("Settings")] [SerializeField] private float handleRange = 1f; // 手柄最大移动范围（相对于底座半径的比例） [SerializeField] private float deadZone = 0.2f; // 死区，小于此值的输入视为0 // Input System 相关 [SerializeField] private InputActionReference moveActionReference; // 引用我们在Asset中定义的Move Action private InputAction moveAction; private Vector2 inputVector = Vector2.zero; private RectTransform baseRect; // 摇杆底座的RectTransform private Canvas parentCanvas; private Camera eventCamera; private void Awake() { baseRect = GetComponent<RectTransform>(); parentCanvas = GetComponentInParent<Canvas>(); if (moveActionReference != null) { moveAction = moveActionReference.action; } else { Debug.LogError("Move Action Reference 未分配！", this); } // 初始化手柄位置 if (handle != null) handle.anchoredPosition = Vector2.zero; } // 当手指按下摇杆区域时 public void OnPointerDown(PointerEventData eventData) { eventCamera = eventData.pressEventCamera; OnDrag(eventData); // 按下时立即更新位置 if (backgroundImage != null) backgroundImage.color = new Color(1f, 1f, 1f, 0.8f); // 视觉反馈：按下时变亮 } // 当手指在摇杆区域拖动时 public void OnDrag(PointerEventData eventData) { // 将屏幕坐标转换为摇杆底座的本地坐标 Vector2 position; if (RectTransformUtility.ScreenPointToLocalPointInRectangle(baseRect, eventData.position, eventCamera, out position)) { // 计算位置相对于底座中心的比例，范围在[-1, 1]之间 position.x = (position.x / baseRect.sizeDelta.x) * 2; position.y = (position.y / baseRect.sizeDelta.y) * 2; inputVector = Vector2.ClampMagnitude(position, 1.0f); // 限制在单位圆内 // 应用死区 if (inputVector.magnitude < deadZone) { inputVector = Vector2.zero; } // 更新手柄的视觉位置 if (handle != null) { Vector2 handlePosition = inputVector * (baseRect.sizeDelta.x / 2f) * handleRange; handle.anchoredPosition = handlePosition; } // 将输入向量传递给Input System的Action UpdateInputAction(); } } // 当手指抬起时 public void OnPointerUp(PointerEventData eventData) { inputVector = Vector2.zero; if (handle != null) handle.anchoredPosition = Vector2.zero; if (backgroundImage != null) backgroundImage.color = new Color(1f, 1f, 1f, 0.5f); // 视觉反馈：恢复透明度 UpdateInputAction(); // 抬起后输入归零 } // 更新Input Action的值 private void UpdateInputAction() { if (moveAction != null) { // 关键步骤：通过InputSystem的API，手动触发一个“虚拟”的控制器输入 // 我们创建一个虚拟的Vector2Control，并将摇杆计算出的值赋给它。 // 更优雅的方式是使用InputSystem.QueueDeltaStateEvent，但这里我们直接写入Action的值。 // 注意：直接修改Action的“读值”在某些架构下可能不被推荐，标准做法是绑定到一个虚拟设备。 // 下面是一种更标准的模拟方式： // 首先，确保我们有一个虚拟设备（例如“Touchscreen”）被添加到系统中。 // 然后，我们可以通过修改该虚拟设备上某个控件的状态来驱动Action。 // 为了简化，这里演示一种直接通过代码“模拟”输入并让Action响应的思路。 // 实际上，更常见的做法是让监听Move Action的脚本直接读取本脚本的inputVector。 // 因此，我们通常不直接写Action，而是提供一个公共方法供其他脚本读取。 // 所以，我们暂时注释掉直接写Action的代码，改为提供属性。 // moveAction.ReadValue<Vector2>() 将由其他系统来读取，我们这里负责产生值。 } } // 提供一个公共属性，让控制角色的脚本能直接读取到摇杆输入 public Vector2 Direction => inputVector; // 可选：在编辑器中可视化摇杆范围 private void OnDrawGizmosSelected() { if (baseRect == null) baseRect = GetComponent<RectTransform>(); Vector3[] corners = new Vector3[4]; baseRect.GetWorldCorners(corners); Vector3 center = (corners[0] + corners[2]) / 2; float radius = (corners[3].y - corners[0].y) / 2 * handleRange; Gizmos.color = Color.green; Gizmos.DrawWireSphere(center, radius); } }

5.3 角色控制器读取虚拟摇杆输入

现在，我们需要一个角色控制脚本（例如PlayerController）来同时响应键盘和虚拟摇杆的移动输入。关键在于，这个脚本只监听MoveAction，而不关心输入具体来自哪里。

using UnityEngine; using UnityEngine.InputSystem; public class PlayerController : MonoBehaviour { [SerializeField] private float moveSpeed = 5f; [SerializeField] private VirtualJoystick virtualJoystick; // 引用场景中的虚拟摇杆脚本 [SerializeField] private InputActionReference moveActionReference; // 引用配置好的Move Action private InputAction moveAction; private Vector2 inputDirection; private Rigidbody2D rb; // 假设是2D角色，3D可使用CharacterController或Rigidbody private void Awake() { rb = GetComponent<Rigidbody2D>(); if (moveActionReference != null) { moveAction = moveActionReference.action; } } private void OnEnable() { if (moveAction != null) moveAction.Enable(); } private void OnDisable() { if (moveAction != null) moveAction.Disable(); } private void Update() { // 方法1：优先从Input System的Action读取输入（这会包含键盘、手柄等所有绑定） inputDirection = moveAction?.ReadValue<Vector2>() ?? Vector2.zero; // 方法2：如果虚拟摇杆有输入，则覆盖Input System的输入（适用于移动设备） // 这是一种混合输入策略：在手机上，摇杆优先级最高。 if (virtualJoystick != null && virtualJoystick.Direction.magnitude > 0.1f) { inputDirection = virtualJoystick.Direction; } // 此时，inputDirection就是最终的角色移动方向向量 } private void FixedUpdate() { // 应用移动 Vector2 movement = inputDirection * moveSpeed * Time.fixedDeltaTime; if (rb != null) { rb.MovePosition(rb.position + movement); } else // 如果没有Rigidbody，简单使用Transform { transform.Translate(new Vector3(movement.x, movement.y, 0)); } } // 可选：你也可以在Input System的Action回调里处理，这样更事件驱动 private void Start() { if (moveAction != null) { moveAction.performed += ctx => { inputDirection = ctx.ReadValue<Vector2>(); }; moveAction.canceled += ctx => { inputDirection = Vector2.zero; }; } } }

关键逻辑解析：在Update方法中，我们首先尝试从moveAction读取输入，这涵盖了所有在.inputactions文件中绑定的设备（键盘、手柄）。然后，我们检查virtualJoystick是否有有效输入。如果有，则用摇杆的输入覆盖前者。这种设计实现了输入源的动态优先级：在PC上，玩家用键盘；在手机上，自动切换到摇杆，代码无需为不同平台写两套逻辑。

5.4 虚拟摇杆的优化与手感调校

一个手感好的虚拟摇杆需要微调。主要参数在VirtualJoystick脚本的Header("Settings")部分：

• handleRange（手柄范围）：通常设为1，表示手柄可以移动到底座边缘。设为小于1的值（如0.8），手柄移动范围会缩小，操作更精确但幅度变小。
• deadZone（死区）：这是最重要的参数之一。摇杆中心一小块区域内的微小移动会被忽略，防止因手指轻微颤抖导致的角色抖动。0.1到0.3是比较常用的范围，需要根据游戏手感测试调整。
• 视觉反馈：我们在OnPointerDown和OnPointerUp中改变了底座的透明度，给玩家明确的触控反馈。你还可以添加手柄的缩放动画、按下效果等。

实操心得：虚拟摇杆的响应区域（RectTransform的大小）最好比视觉上的底座图片大一圈。这样玩家在点击摇杆附近时也能触发，操作容错率更高。可以通过调整JoystickBG对象的RectTransform的Width和Height来实现，而不改变图片本身的缩放。

6. 高级技巧与实战避坑指南

掌握了基础实现后，下面这些经验能让你在项目中更游刃有余。

6.1 多控制方案与动态切换

Input System的强大之处在于能优雅处理多控制方案。例如，你的游戏同时支持键鼠和手柄。

1. 在.inputactions文件中定义方案：在编辑器中，你可以为PlayerAction Map添加多个控制方案。在Bindings面板，每个绑定都可以选择所属的Control Scheme。你可以为“移动”绑定WASD（属于“键盘鼠标”方案）和左摇杆（属于“游戏手柄”方案）。
2. 在代码中检测与切换：

   var playerActions = inputActions.FindActionMap("Player"); // 启用时，Input System会自动尝试匹配当前活跃的设备方案 playerActions.Enable(); // 你可以监听设备变化 InputSystem.onActionChange += (obj, change) => { if (change == InputActionChange.ActionPerformed) { var action = obj as InputAction; // 获取触发该动作的设备 var device = action?.activeControl?.device; if (device is Gamepad) { Debug.Log("玩家正在使用手柄操作"); // 可以在这里更新UI提示图标等 } else if (device is Keyboard) { Debug.Log("玩家正在使用键鼠操作"); } } };

3. 为虚拟摇杆创建独立的“触屏”方案：更规范的做法是，为虚拟摇杆也创建一个名为“Touch”的Control Scheme。然后，在运行时，当检测到是移动平台时，用代码动态地为MoveAction添加一个绑定，其路径指向一个虚拟的触屏控制（这需要更底层的Input Device API）。不过，对于我们之前的混合输入方法（PlayerController中判断摇杆优先级），在中小型项目中已经足够简洁有效。

6.2 输入动作的交互类型（Interaction）与处理器（Processor）

这是Input System的进阶功能，能极大简化复杂输入逻辑。

• 交互（Interactions）：可以附加到Button类型的Action上，定义如何解释一次按压。例如：

  • Tap（点击）：快速按下并释放。
  • Hold（长按）：按住一段时间。
  • MultiTap（多次点击）：连续点击多次。
  • SlowTap/FastTap（慢速/快速点击）。 你可以在.inputactions文件里为Action添加Interaction，然后在代码中通过ctx.interaction来判断是哪种交互被触发，无需自己用计时器实现长按检测。

• 处理器（Processors）：可以附加到任何Action上，对读取到的原始输入值进行加工。例如：

  • Stick Deadzone：为摇杆添加死区（和我们自己在摇杆脚本里做的类似，但更标准化）。
  • Scale Vector2：缩放向量值。
  • Invert：反转值。
  • Normalize Vector2：将非标准方向的输入向量标准化（常用于将键盘的8方向输入归一化）。 对于键盘移动，强烈建议为MoveAction的WASD绑定添加一个Normalize Vector2处理器。因为同时按住W和D时，原始向量是(1,1)，长度是√2≈1.414，会导致斜向移动比轴向移动快。归一化后，向量长度始终为1（在最大输入时），移动速度就一致了。

6.3 常见问题排查与调试

1. UI不响应键盘：

   • 检查EventSystem上是否有且仅有Input System UI Input Module。
   • 检查PlayerControls.inputactions资源中，UIAction Map下的Action命名是否正确（Submit，Cancel，Navigate）。
   • 检查UIAction Map是否被启用。Input System UI Input Module应该会自动启用它。

2. 虚拟摇杆没反应：

   • 检查VirtualJoystick脚本是否挂载在摇杆底座UI对象上，且Handle字段是否正确赋值。
   • 检查摇杆底座的RectTransform是否足够大，确保能接收到触屏事件。可以临时添加一个带颜色的Image组件查看范围。
   • 在PlayerController的Update中Debug.LogvirtualJoystick.Direction和moveAction.ReadValue<Vector2>()，看哪个有值。

3. 输入冲突或重复触发：

   • 确保在不同的游戏状态下，正确启用/禁用对应的Action Map。例如，打开背包界面时，禁用PlayerMap，启用UIMap。
   • 注意Action的回调函数绑定和解绑要成对出现（在OnEnable/OnDisable或Start/OnDestroy中），防止重复绑定导致函数被多次调用。

4. 在编辑器里测试触屏输入：

   • 在Game窗口，点击右上角的Display 1下拉菜单，选择Maximize on Play下方的Touchscreen模拟选项。这样你就可以用鼠标来模拟手指触摸了，对于调试虚拟摇杆非常方便。

从老旧的Input类迁移到全新的Input System，初期确实有学习成本，但一旦掌握，其带来的代码清晰度、可维护性和跨平台能力的提升是巨大的。它强迫你以“玩家意图”而非“具体按键”来思考输入逻辑，这本身就是一种更好的设计模式。虚拟摇杆的实现也展示了如何将自定义输入源无缝集成到这套系统中。希望这篇详尽的指南能帮你顺利上手，少走弯路。如果在实际项目中遇到更特殊的需求，多查阅Unity官方手册中关于Input System的底层API，它的灵活性远超这篇指南所能覆盖的范围。