> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 通过 NuGet 在 PC 和主机上使用 GameInput

> 通过 NuGet 在 PC 和主机上使用 GameInput

<a id="introductionSection" />

若要使用 GameInput 的最新能力 (v.1+)，请使用 [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput) NuGet 包为 Visual Studio 做开发准备。虽然新版 Windows 开箱即支持 GameInput，但为了在 PC 上开发和发布时使用最新的 GameInput 功能与更新，务必安装 NuGet 包中包含的 GameInput 可再发行组件。

对于主机，无需 GameInput 安装程序，因为它是 Microsoft Game Development Kit (GDK) 的一部分。但仍需要该包以获取最新的 GameInput 头文件和最新的静态库。新的静态库包含正确的逻辑，可在主机上定位到对应版本的 GameInput 运行时，从而访问 v.1+ 功能。

## 面向 PC 的 GameInput 可再发行组件

<a id="redistributableSection" />

<Note>NuGet 包中包含 GameInput 可再发行组件，但不会自动安装。</Note>

尽管新版 Windows 开箱即支持 GameInput，但 PC 游戏必须将 GameInput 可再发行组件纳入其安装程序中。安装 GameInput NuGet 包时，`GameInputRedist.msi` 安装程序会放入 `packages\Microsoft.GameInput.<version>\redist` 目录，通常位于你的项目根目录下。

如果你在开发 GDK PC 游戏，请参阅有关[自定义安装操作](/build/core-features/common/packaging/packaging-custom-install-actions)的文档，了解如何在发布时将此包与你的游戏一同包含。如果你在开发非 GDK PC 游戏，请确保将此可再发行组件作为常规游戏安装的一部分进行安装。

GameInput 可再发行组件会验证不会导致目标系统上的 GameInput 降级。虽然此检查意味着你的游戏可在安装了比开发时更新版本的 GameInput 的 PC 上运行，但 GameInput API 仍保持向后兼容，从而在未来保持一致行为。

## 通过 WinGet 在系统中部署最新的 GameInput

对于开发场景，Windows Package Manager (WinGet) 也提供 GameInput 可再发行组件，与 [Microsoft.GameInput](https://www.nuget.org/packages/Microsoft.GameInput) NuGet 包中的一致。这样你可以快速在开发计算机上部署最新的 GameInput 可再发行组件。只需在提升权限的命令提示符中运行以下命令即可轻松安装最新的 GameInput 可再发行组件：

```powershell theme={null}
winget install Microsoft.GameInput
```


## Related topics

- [GameInput 常见问题](/zh-CN/build/core-features/common/input/overviews/input-faq.md)
- [GameInput API 版本管理](/zh-CN/build/core-features/common/input/overviews/input-versioning.md)
- [GameInput 概述](/zh-CN/build/core-features/common/input/overviews/input-overview.md)
- [输入 API 参考](/zh-CN/reference/input/gc-reference-input-toc.md)
- [概述](/zh-CN/build/core-features/common/input/overviews/index.md)