译注:本文中的图片尚未汉化。
安装指南
本页介绍了如何为您的 Unity 项目安装并启用输入系统扩展包(Input System package)。
提示
此版本的输入系统需要 .NET 4 运行时。它无法在运行旧版 .NET 3.5 运行时的项目中使用。
此扩展包仅兼容 2021.3 及更高版本的 Unity 编辑器 。如果您使用的编辑器版本低于 2021.3,则需要改用与编辑器版本兼容的扩展包版本,具体请参考 Unity 包管理器 (Unity Package Manager) 窗口中带有 Release 标签的版本。
安装扩展包
若要安装新的输入系统:
-
在 Unity 编辑器的主菜单中,前往 窗口(Windows) > 包管理器(Package Manager) 以打开 Unity 包管理器。1
-
从导航面板中选择 Unity 注册表(Unity Registry)。
-
从列表中选择 Input System 扩展包。
包管理器默认会自动选择该版本进行安装。
-
点击 安装(Install),并根据提示启用新输入系统的后端(backends)。
此扩展包还提供了几个关于如何使用新输入系统的示例,这些示例同样可以在 Unity 包管理器 窗口中找到。请参阅 安装示例。
启用新的输入后端
默认情况下,Unity 旧版的输入管理器(UnityEngine.Input)处于激活状态,而对新输入系统的支持处于未激活状态。这使得现有的 Unity 项目可以保持原样继续运行。
当您安装输入系统扩展包时,Unity 会询问是否要启用新的后端。点击 Yes 以启用新后端并禁用旧后端。在此过程中,编辑器将会重启。

您可以在 编辑(Edit) > 项目设置(Project Settings) > 玩家(Player) > 其他设置(Other Settings) > 活动输入处理(Active Input Handling) 中找到对应的设置。如果您更改了此设置,必须重启编辑器才能生效。
提示
您可以同时启用旧系统和新系统。为此,请将 活动输入处理(Active Input Handling) 设置为 两个(Both)。

当启用新的输入后端时,ENABLE_INPUT_SYSTEM=1 这一 C# #define 宏会被添加到构建(builds)中。类似地,当启用旧的输入后端时,ENABLE_LEGACY_INPUT_MANAGER=1 这一 C# #define 宏会被添加。由于两者可以同时启用,因此这两个宏定义可能同时为 1。
安装示例
输入系统扩展包附带了许多示例。您可以直接从 Unity 的包管理器窗口 (窗口(Window) > 包管理器(Package Manager)) 安装这些示例。1要查看示例列表,请在包管理器窗口中选择输入系统扩展包,然后点击 Samples 选项卡。接着,点击任何示例名称旁边的 Import 即可将其导入到当前项目。

有关输入系统更全面的演示项目,请参阅 GitHub 上的 战士(InputSystem_Warriors) 仓库。