Unity 输入系统（软件包）

Unity 输入系统软件包是 Unity 平台的扩展包，提供了一个系统来配置游戏动作并访问输入设备以与 Unity 内容交互。它旨在成为 Unity 输入 API（UnityEngine.Input 类）的更强大、灵活和可配置的替代品。

先决条件

当前版本的输入系统需要 Unity 2019 LTS、Unity 2020 LTS、Unity 2021 或 Unity Beta（可能存在不稳定性）以及包含的工具来编译和运行。推荐通过 Unity Hub 安装 Unity。

入门

有关如何开始在 Unity 中使用输入系统的说明，请参阅输入系统手册 - 安装。

有关如何使用输入系统的教程可在以下资源中找到：

• Unity Learn - 在 Unity 中使用输入系统 - 关于如何在 Unity 中使用输入系统的视频教程。
• Warriors 演示项目 - 一个演示项目，展示了输入系统中的广泛工具和功能，包括使用不同输入方法的本地多人游戏。
• 本仓库中的示例项目：
  • 自定义复合 - 展示如何实现和注册自定义 InputBindingComposite。
  • 自定义设备 - 演示如何添加和创作自定义设备。
  • 自定义设备用途 - 展示如何用自定义"用途"标记设备，以及如何将动作特定绑定到仅具有这些用途的设备。
  • 游戏手柄鼠标光标 - 一个由游戏手柄输入驱动的 UI 指针导航示例。
  • 游戏内提示 - 说明如何在 UI 中显示涉及动作绑定和对象交互的文本。
  • 输入记录器 - 演示如何使用 InputEventTrace 和 InputRecorder。
  • 屏幕控件 - 演示如何设置和使用屏幕上类似游戏手柄的控件。
  • 重新绑定 UI - 演示如何设置重新绑定 UI 以在运行时重新配置绑定。
  • 简单演示 - 展示如何使用动作、动作资产以及 PlayerInput 组件设置简单的角色控制器。
  • 简单多人游戏 - 演示基本的分屏本地多人游戏设置，玩家可以通过按支持设备上的按钮加入游戏。
  • UI 与游戏输入 - 说明如何处理输入并解决在游戏视图中叠加 UI 元素时产生的歧义。
  • 可视化工具 - 为常见设备提供各种输入数据可视化。

如何在 Unity 项目中使用已发布版本的软件包

输入系统软件包的所有已发布版本都可通过 Unity 包管理器获得，请参阅输入系统手册 - 安装以了解如何获取软件包和兼容版本的示例并将其安装到您的 Unity 项目中的说明。

如何在 Unity 项目中使用软件包的最新更改

要测试最新（未发布）的更改：

1. 克隆 develop 分支。develop 分支的目的是始终保持可发布状态，但它反映了当前的开发情况，可能包含最新发布版本中不存在的错误或意外行为。
2. 按照 Unity 手册 - 从本地文件夹安装软件包中描述的步骤将本地软件包添加到您的项目中，并选择 Packages/com.unity.inputsystem/package.json。

开发输入系统的推荐方法

1. 克隆 develop 分支或所需的分支或发布标签。
2. 在 Unity 编辑器中打开仓库的根文件夹。这样，您就可以访问仅导入软件包到其他 Unity 项目时被排除的测试和示例。

在开发过程中，通过选择窗口 > 常规 > 测试运行器来访问测试运行器，并选择运行所有 PlayMode 或 EditMode 测试来运行输入系统自动化测试。

贡献与反馈

该项目由 Unity Technologies 开发，但欢迎用户贡献和反馈。

如果您对 Unity 的输入系统有任何反馈或问题，欢迎您加入我们的 Unity 论坛。

如果您想为输入系统的开发做出贡献，请参阅 CONTRIBUTIONS.md 以获取更多信息。

许可证

该软件包根据 Unity 相关项目的 Unity Companion License 分发，并附加了第三方许可证，特别适用于 Assets/Samples/RebindingUI 示例项目。