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

# GDK 中的用户身份与 XUser API

> 面向使用 2022 年 6 月或更高版本 Microsoft Game Development Kit 构建的 XBOX 与 PC 游戏的用户模型选择、XUser 身份 API 以及登录流程。

浏览 XBOX 游戏开发中的用户相关主题。

> [card] [Microsoft Game Development Kit 用户模型](https://docs.xbox.com/zh-CN/build/core-features/common/user/gamecore-user-models.md)
>
> 从 2022 年 6 月的 GDK 开始，PC 和主机上的游戏都可以选择用户模型。

> [card] [用户身份和 XUser](https://docs.xbox.com/zh-CN/build/core-features/common/user/player-identity-xuser.md)
>
> XBOX Series X|S 使用 XUser 对象来管理与游戏交互的用户的身份。

> [card] [用户](https://docs.xbox.com/zh-CN/build/core-features/common/user/user-toc.md)
>
> 本节介绍 Microsoft Game Development Kit (GDK) 的用户概念、用户如何表示为 XUser，以及……

> [card] [更改游戏的默认用户](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-changing-default-user.md)
>
> XR-112 要求游戏提供帐户选择器的入口点，以允许更改活跃（默认）用户。

> [card] [处理控制器丢失](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-dealing-with-controller-loss.md)
>
> 将控制器关联到用户对于大多数游戏至关重要。

> [card] [为游戏建立默认用户](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-establishing-default-user.md)
>
> 当游戏选择使用简化用户模型时，游戏可以使用 AddDefaultUserSilently 选项调用 XUserAddAsync，并且是……

> [card] [访客用户](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-guest-overview.md)
>
> 访客用户（也称为\_\_\_赞助访客\_\_\_或\_\_\_访客帐户\_\_\_）允许玩家与许多 XBOX 服务交互，而无需……

> [card] [XUser 的无头自动化](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-headless-automation.md)
>
> 出于测试目的，游戏可能希望自动将用户添加到游戏中。

> [card] [用户与输入设备](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-input-devices.md)
>
> 游戏需要知道哪些输入设备关联到指定用户。

> [card] [选择加入默认用户要求](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-opting-into-simplified-model.md)
>
> 要选择加入简化用户模型，你需要在 microsoftgame.config 中添加 \AdvancedUserMode\ 并指定 "false"，如下所示。

> [card] [用户与控制器的关联何时发生？](https://docs.xbox.com/zh-CN/build/core-features/common/user/users-timing-of-user-to-device-association.md)
>
> 当控制器成功关联到用户时，按下该控制器上的 nexus 按钮将显示该用户的个性化……

> [card] [XUser 跨平台支持](https://docs.xbox.com/zh-CN/build/core-features/common/user/xuser-crossplatform.md)
>
> XUser 是 Gaming Runtime API，用于跨平台管理 XBOX 用户帐户和身份验证。

> [card] [How-to：用户登录的最佳实践](https://docs.xbox.com/zh-CN/build/core-features/common/user/xuser_howto_best_practice_signing_in.md)
>
> 游戏需要建立一个初始用户。

## 另请参阅

* [异步](https://docs.xbox.com/zh-CN/build/core-features/common/async/index.md)
* [游戏配置](https://docs.xbox.com/zh-CN/build/core-features/common/game-config/index.md)
* [游戏存档](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/index.md)
* [游戏串流](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/index.md)
* [输入](https://docs.xbox.com/zh-CN/build/core-features/common/input/index.md)
* [光照](https://docs.xbox.com/zh-CN/build/core-features/common/lighting/index.md)
* [打包](https://docs.xbox.com/zh-CN/build/core-features/common/packaging/index.md)


## Related topics

- [用户身份与 XUser](https://docs.xbox.com/zh-CN/build/core-features/common/user/player-identity-xuser.md)
- [用户](https://docs.xbox.com/zh-CN/build/core-features/common/user/user-toc.md)
- [XUser 跨平台支持](https://docs.xbox.com/zh-CN/build/core-features/common/user/xuser-crossplatform.md)
- [账户身份验证和访问概述](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/identity/auth/live-authentication-overview.md)
- [如何:登录用户的最佳实践](https://docs.xbox.com/zh-CN/build/core-features/common/user/xuser_howto_best_practice_signing_in.md)