企业官网建设流程全解析

1. 项目概述：为什么Unity开发者绕不开Input System？

如果你是从Unity的旧版Input Manager（就是那个在Input类里写GetKeyDown和GetAxis的时代）一路走过来的老鸟，或者你是一个刚入门就被各种输入设备搞得晕头转向的新手，那么“Input System”这个词对你来说，绝对不是一个陌生的概念。它更像是一个摆在面前、迟早要翻越的山头。我刚开始接触时，也犯过嘀咕：旧系统用得好好的，为什么要换？但当你真正开始做一个需要支持手柄、触屏、键盘鼠标无缝切换，或者想实现一套复杂的技能连招系统时，旧Input Manager那种“硬编码”和“设备强绑定”的弊端就暴露无遗了。

简单来说，Unity的新Input System是一个现代化、事件驱动、设备无关的输入处理框架。它把“按下A键”或“移动右摇杆”这些底层硬件信号，抽象成了更高层级的“动作”（Actions），比如“跳跃”、“移动”、“攻击”。你的游戏逻辑只关心这些“动作”是否被触发，至于这个“跳跃”动作是由空格键、手柄A键还是屏幕上的一个虚拟按钮触发的，Input System帮你搞定。这带来的好处是巨大的：代码与设备解耦，一套逻辑适配所有输入方式；输入配置可动态修改，甚至允许玩家自定义按键；对新型输入设备（如VR控制器、方向盘）的支持更加优雅。

所以，这个“进阶”学习系列的第一篇，我们就从最实在的地方开始：如何把它导入到你的项目里，以及如何用最基础的API去“摸到”那些连接着的设备。别看这是基础，很多人在第一步配置上就卡住了，或者因为不熟悉新的API而觉得无从下手。我会带你绕开这些坑，用最直白的方式，让你快速上手。

2. 核心思路：事件驱动与动作映射

在深入代码之前，我们必须先理解Input System的设计哲学，这能帮你少走很多弯路。旧Input Manager是典型的“轮询”（Polling）模式：你在Update()里不停地问“空格键按下了吗？”。而新Input System的核心是“事件驱动”（Event-driven）。

你可以把它想象成一个高效的邮局。各种输入设备（键盘、鼠标、手柄）是发信人，它们产生事件（“按键按下”、“摇杆移动”）。Input System是邮局的分拣中心，它根据你预先定义好的“动作映射表”（Action Maps），将这些原始事件分拣成有意义的“动作”包裹（比如“跳跃请求”）。最后，你的游戏逻辑是收件人，它只需要监听并处理这些“动作”包裹，完全不用关心包裹是哪个发信人、通过什么路线送来的。

这种设计的优势在于：

1. 高效：只在输入事件发生时执行代码，避免了Update中的空轮询。
2. 清晰：输入逻辑（定义动作）和游戏逻辑（响应动作）分离，项目结构更干净。
3. 灵活：动态切换输入方案（例如，从键鼠切换到手柄）变得非常简单，只需启用不同的“动作映射集”即可。

我们本篇要学习的“基础设备调用API”，实际上是在和“分拣中心”的基础设施打交道，比如查询当前有哪些“发信人”（设备）在线，或者直接监听某个“发信人”的原始事件。这在调试、创建自定义输入设备管理器或处理一些非常规输入时非常有用。

3. 第一步：导入Input System的三种方式与避坑指南

这是所有事情的起点，但Unity的包管理有时会给你设点小障碍。以下是三种主流方式，我会详细说明每种方式的适用场景和可能遇到的坑。

3.1 通过Package Manager安装（推荐）

这是最标准、最推荐的方式，能确保你获取到的是经过Unity验证的兼容版本。

1. 打开Unity，进入顶部菜单Window > Package Manager。
2. 在Package Manager窗口左上角，点击“Packages”下拉菜单，选择“Unity Registry”。这是关键一步，如果你停留在“My Assets”或“In Project”，可能找不到它。
3. 在列表中找到“Input System”。你可以使用右上角的搜索框直接搜索。
4. 点击它，在右侧详情面板中点击“Install”按钮。

注意：点击安装后，Unity会弹出一个警告对话框，提示“Input System将禁用旧的Input Manager”。这是正常的，也是必须的。两个系统可以共存，但同一时间只能有一个处于激活状态。直接点击“Yes”确认。如果你后续需要切换回去，可以在Edit > Project Settings > Player中，找到“Active Input Handling”选项进行更改。

可能遇到的坑：

• 找不到包？请确保你的Unity版本是2019.1或更高，并且Package Manager源切换到了“Unity Registry”。2019.1是Input System正式发布的最低版本。
• 安装失败？检查网络连接，或者尝试重启Unity和Package Manager。

3.2 通过Unity Registry直接安装（命令行/快速）

对于喜欢终端或者需要自动化脚本的开发者，可以使用Unity的命令行工具。打开系统命令行（Windows的CMD/PowerShell，Mac的Terminal），导航到你的项目根目录，然后执行：

unity -batchmode -projectPath . -executeMethod UnityEditor.PackageManager.Client.Add -args "com.unity.inputsystem"

这种方式适合CI/CD流水线，但在日常开发中不如图形界面直观。

3.3 手动修改manifest.json（高级/特定版本）

有时你可能需要锁定一个特定的、非最新的Input System版本。这时可以手动修改项目。

1. 在你的Unity项目文件夹中，找到Packages/manifest.json文件。
2. 用文本编辑器打开它。
3. 在dependencies区块中，添加或修改这样一行：

   "com.unity.inputsystem": "1.7.0",

4. 保存文件，返回Unity，它会自动开始解析和导入这个指定版本的包。

实操心得：我强烈建议新手使用第一种方式（Package Manager）。它能最大程度避免版本冲突和依赖问题。只有在你知道自己需要某个特定版本来解决兼容性问题时，才考虑第三种方式。安装完成后，你会在Package Manager的 “In Project” 列表中看到它，并且菜单栏会多出一个“Edit > Project Settings > Input System Package”的选项，这说明导入成功了。

4. 基础设备调用API详解：与硬件直接对话

导入成功后，我们就可以开始写代码了。Input System的核心命名空间是UnityEngine.InputSystem。我们先从最基础的——获取和监听输入设备开始。这部分API让你能直接接触到“邮局”的“发信人列表”。

4.1 枚举所有已连接的设备

InputSystem.devices是一个静态列表，包含了当前所有被Input System识别并连接的输入设备。

using UnityEngine; using UnityEngine.InputSystem; // 关键：引入命名空间 public class DeviceLister : MonoBehaviour { void Start() { // 遍历所有设备并打印信息 foreach (var device in InputSystem.devices) { Debug.Log($"设备名称: {device.displayName}, 类型: {device.GetType()}, 设备ID: {device.deviceId}"); // 你可以进一步判断设备具体类型 if (device is Gamepad) { Debug.Log(" 这是一个手柄！"); Gamepad gamepad = device as Gamepad; // 现在你可以访问gamepad特有的属性，如 gamepad.aButton } else if (device is Keyboard) { Debug.Log(" 这是一个键盘！"); } else if (device is Mouse) { Debug.Log(" 这是一个鼠标！"); } // 还可以判断Touchscreen, Pen, Sensor等 } } }

为什么需要这个？在游戏开始时的输入设备检测、创建动态的键位设置界面（显示当前连接了哪些手柄）、或者为不同设备初始化不同的默认配置时，这个API非常有用。

4.2 监听设备的连接与断开事件

游戏运行时，玩家可能会插拔手柄。我们需要动态响应这些变化。

public class DeviceMonitor : MonoBehaviour { private void OnEnable() { // 订阅设备连接事件 InputSystem.onDeviceChange += OnDeviceChange; } private void OnDisable() { // 取消订阅，防止内存泄漏！ InputSystem.onDeviceChange -= OnDeviceChange; } private void OnDeviceChange(InputDevice device, InputDeviceChange change) { switch (change) { case InputDeviceChange.Added: Debug.Log($"设备已连接: {device.displayName}"); // 例如：自动将新连接的手柄设为玩家2 break; case InputDeviceChange.Removed: Debug.Log($"设备已断开: {device.displayName}"); // 例如：处理玩家掉线逻辑 break; case InputDeviceChange.ConfigurationChanged: Debug.Log($"设备配置已更改: {device.displayName}"); // 例如：手柄电量低或配置文件切换 break; // 还有其他枚举值，如Enabled, Disabled, UsageChanged等 } } }

注意事项：

• 一定要订阅和取消订阅配对出现。在OnEnable中订阅，在OnDisable或OnDestroy中取消订阅，这是Unity事件系统的良好实践，避免脚本禁用或物体销毁后仍被调用，导致空引用或逻辑错误。
• InputDeviceChange.ConfigurationChanged对于支持宏或配置切换的专业设备（如一些高端手柄或方向盘）很有用。

4.3 获取特定类型的默认设备

通常，我们关心的是“玩家1用的手柄”或“主键盘”。Input System提供了便捷的获取方式。

void CheckDefaultDevices() { // 获取当前平台默认的游戏手柄（通常是最近连接或第一个识别的手柄） Gamepad currentGamepad = Gamepad.current; if (currentGamepad != null) { Debug.Log($"当前默认手柄: {currentGamepad.displayName}"); // 直接读取状态 if (currentGamepad.aButton.wasPressedThisFrame) { Debug.Log("默认手柄的A键被按下了！"); } } else { Debug.LogWarning("未检测到连接的手柄。"); } // 同样可以获取键盘和鼠标 Keyboard keyboard = Keyboard.current; Mouse mouse = Mouse.current; if (keyboard != null && keyboard.spaceKey.wasPressedThisFrame) { Debug.Log("空格键被按下（通过.current）"); } }

核心要点：

• .current属性是获取“主要”或“最相关”设备的最快方式。对于鼠标键盘，在PC上基本总是有效的。对于手柄，它通常指向第一个可用的手柄。
• 在访问.current或任何设备属性前，进行空值检查 (!= null) 是一个好习惯，因为设备可能在任何时候被拔掉。

4.4 直接读取设备状态（低层级API）

虽然Input System鼓励使用“动作”（Action），但有时你需要直接读取原始数据，比如做一个设备测试工具。

public class RawInputReader : MonoBehaviour { void Update() { var gamepad = Gamepad.current; if (gamepad != null) { // 读取左摇杆的二维向量值 Vector2 leftStickValue = gamepad.leftStick.ReadValue(); if (leftStickValue.magnitude > 0.1f) // 加入一个死区阈值 { Debug.Log($"左摇杆: {leftStickValue}"); } // 读取右扳机键的压力值（0到1） float rightTriggerValue = gamepad.rightTrigger.ReadValue(); if (rightTriggerValue > 0.2f) { Debug.Log($"右扳机压力: {rightTriggerValue}"); } // 判断按钮是否在本帧被按下 if (gamepad.buttonSouth.wasPressedThisFrame) // 通常是A键（Xbox布局）或Cross键（PlayStation布局） { Debug.Log("A/X键被按下！"); } } // 直接读取键盘事件 var keyboard = Keyboard.current; if (keyboard != null) { // 同时检测多个按键 if (keyboard.wKey.isPressed && keyboard.leftShiftKey.isPressed) { Debug.Log("正在冲刺（W+Shift）"); } } } }

与旧Input Manager的对比：这里gamepad.leftStick.ReadValue()类似于旧的Input.GetAxis(“Horizontal”)，但它是直接从设备对象获取，更面向对象。wasPressedThisFrame和isPressed则对应GetKeyDown和GetKey。

重要区别：Input System中的wasPressedThisFrame等状态，其“帧”的判断是基于Input System自己的更新时机（默认与MonoBehaviour.Update同步），但也可以配置为固定更新或手动更新，这比旧系统更灵活。

5. 从设备API到动作映射的桥梁：PlayerInput组件初探

学完基础设备API，你可能会觉得：“这好像和旧系统差不多啊，还是要手动查设备、读数值。” 别急，这只是为了让你理解底层。Input System的威力在于上层的“动作映射”。Unity提供了一个非常方便的组件PlayerInput来帮你快速搭建这座桥梁。

虽然本系列后续会深入讲解自己创建Input Action Asset，但这里可以先感受一下PlayerInput的便捷：

1. 创建动作资源：在Project窗口右键Create > Input Actions，命名为“PlayerControls”。
2. 双击打开编辑器，创建一个“Gameplay” Action Map，在里面添加两个Action：
   • “Move”（2D Vector类型），绑定到Gamepad的左摇杆和键盘的WASD。
   • “Jump”（Button类型），绑定到Gamepad的South按钮和键盘空格键。
3. 保存资源。
4. 在游戏对象上添加PlayerInput组件。
5. 将“PlayerControls”这个Asset拖拽到组件的“Actions”属性上。
6. 在“Behavior”属性中，选择“Invoke Unity Events”。

现在，你不需要在Update里写任何检测代码。只需要在PlayerInput组件暴露出来的UnityEvent中，关联你的处理函数：

public class PlayerController : MonoBehaviour { public void OnMove(InputAction.CallbackContext context) { // context.ReadValue<Vector2>() 直接给你移动向量 Vector2 direction = context.ReadValue<Vector2>(); Debug.Log($"移动输入: {direction}"); // 这里可以驱动角色移动 } public void OnJump(InputAction.CallbackContext context) { // context.started 表示按钮按下开始的瞬间 if (context.started) { Debug.Log("跳跃！"); // 这里触发跳跃逻辑 } } }

PlayerInput组件自动帮你处理了所有设备的绑定、事件监听和路由，你的代码只需要关心高层的“移动”和“跳跃”动作。这才是Input System的正确打开方式。基础设备API是你需要知道的“后台知识”，而动作映射才是你日常开发的“主力工具”。

6. 常见问题与排查技巧实录

在实际使用基础API时，我踩过不少坑，这里总结一下，希望能帮你节省时间。

问题1：InputSystem.devices列表为空，或者Gamepad.current为null。

• 可能原因1：项目设置中未启用Input System。去Edit > Project Settings > Player > Other Settings，查看“Active Input Handling”是否选择了“Input System Package (New)”或“Both”。必须选前两者之一。
• 可能原因2：脚本执行顺序问题。在Awake中访问设备可能太早，Input System尚未初始化完毕。将设备访问代码移到Start或OnEnable中更安全。
• 可能原因3：真的没有设备连接，或者设备驱动异常。尝试插拔设备，或检查系统设备管理器。

问题2：手柄输入有延迟或不跟手。

• 排查：检查Input System的更新模式。在Edit > Project Settings > Input System Package中，有一个“Update Mode”选项。
  • Fixed Update：与物理更新同步，输入采样频率固定，适合物理相关的输入，但可能感觉延迟。
  • Dynamic Update：默认选项。尽可能快地处理输入，通常感觉最跟手。
  • Manual Update：需要手动调用InputSystem.Update()，适用于特定框架如ECS。新手不要选这个。
  • 建议：对于大多数动作游戏，保持“Dynamic Update”即可。

问题3：同时连接多个同型号手柄时，如何区分玩家1和玩家2？

• 解决方案：基础API中，InputSystem.devices列表的顺序并不总是代表玩家顺序。更可靠的做法是：
  1. 利用InputSystem.onDeviceChange事件监听设备连接。
  2. 当手柄连接时（InputDeviceChange.Added），将其加入一个你自己管理的“可用手柄”列表。
  3. 在游戏逻辑中（如角色选择界面），让玩家按手柄上的某个键（如Start键）来“认领”这个手柄，并将其与你游戏中的“玩家索引”绑定。
  4. 之后，通过你绑定的索引来访问特定的手柄对象，而不是依赖.current。

问题4：在编辑器里运行正常，打包后输入无效。

• 排查：这是最常见的问题之一。
  • 首先检查：打包设置中是否包含了Input System需要的资源。确保你的Input Action Asset（.inputactions文件）在打包的Resources文件夹或Addressables加载路径中。最简单的方法是将它放在Resources文件夹下，或者确保它在Project Settings > Player > Publishing Settings的Managed Stripping Level设为Low或Medium（防止代码剥离过度）。
  • 检查依赖：Input System包本身已经包含在构建中，但如果你用了任何自定义的输入设备插件，需要确保它们也被正确打包。

问题5：如何模拟输入，用于测试或录制回放？

• 技巧：Input System提供了强大的模拟输入API。你可以创建一个InputDevice的模拟器。

  // 创建一个虚拟手柄 var virtualGamepad = InputSystem.AddDevice<Gamepad>(); // 然后你可以通过代码“按下”它的按钮 InputSystem.QueueStateEvent(virtualGamepad, new GamepadState { .buttonSouth = true }); // 这会在下一帧触发所有绑定到“South按钮”的动作，非常适合自动化测试。

掌握了这些基础设备API，你就有了直接与硬件对话的能力。它们是构建更复杂输入逻辑的基石。但请记住，在大多数实际游戏开发中，你应该尽快过渡到使用Input Action Asset和PlayerInput组件（或自己管理InputAction）这种更高层、更声明式的模式，这才是发挥Input System全部威力的地方。下一篇，我们将深入那个强大的可视化配置工具——Input Action Editor，学习如何优雅地定义和管理你所有的游戏输入。