> ## 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.

# GDK 中的用户身份与 XUser API

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

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

<CardGroup cols={2}>
  <Card title="Microsoft Game Development Kit 用户模型" icon="user" href="/build/core-features/common/user/gamecore-user-models">
    从 2022 年 6 月的 GDK 开始，PC 和主机上的游戏都可以选择用户模型。
  </Card>

  <Card title="用户身份和 XUser" icon="right-to-bracket" href="/build/core-features/common/user/player-identity-xuser">
    XBOX One 使用 XUser 对象来管理与游戏交互的用户的身份。
  </Card>

  <Card title="用户" icon="user" href="/build/core-features/common/user/user-toc">
    本节介绍 Microsoft Game Development Kit (GDK) 的用户概念、用户如何表示为 XUser，以及……
  </Card>

  <Card title="更改游戏的默认用户" icon="user" href="/build/core-features/common/user/users-changing-default-user">
    XR-112 要求游戏提供帐户选择器的入口点，以允许更改活跃（默认）用户。
  </Card>

  <Card title="处理控制器丢失" icon="gamepad" href="/build/core-features/common/user/users-dealing-with-controller-loss">
    将控制器关联到用户对于大多数游戏至关重要。
  </Card>

  <Card title="为游戏建立默认用户" icon="user" href="/build/core-features/common/user/users-establishing-default-user">
    当游戏选择使用简化用户模型时，游戏可以使用 AddDefaultUserSilently 选项调用 XUserAddAsync，并且是……
  </Card>

  <Card title="访客用户" icon="circle-info" href="/build/core-features/common/user/users-guest-overview">
    访客用户（也称为\_\_\_赞助访客\_\_\_或\_\_\_访客帐户\_\_\_）允许玩家与许多 XBOX 服务交互，而无需……
  </Card>

  <Card title="XUser 的无头自动化" icon="user" href="/build/core-features/common/user/users-headless-automation">
    出于测试目的，游戏可能希望自动将用户添加到游戏中。
  </Card>

  <Card title="用户与输入设备" icon="user" href="/build/core-features/common/user/users-input-devices">
    游戏需要知道哪些输入设备关联到指定用户。
  </Card>

  <Card title="选择加入默认用户要求" icon="user" href="/build/core-features/common/user/users-opting-into-simplified-model">
    要选择加入简化用户模型，你需要在 microsoftgame.config 中添加 \AdvancedUserMode\ 并指定 "false"，如下所示。
  </Card>

  <Card title="用户与控制器的关联何时发生？" icon="user" href="/build/core-features/common/user/users-timing-of-user-to-device-association">
    当控制器成功关联到用户时，按下该控制器上的 nexus 按钮将显示该用户的个性化……
  </Card>

  <Card title="XUser 跨平台支持" icon="user" href="/build/core-features/common/user/xuser-crossplatform">
    XUser 是 Gaming Runtime API，用于跨平台管理 XBOX 用户帐户和身份验证。
  </Card>

  <Card title="How-to：用户登录的最佳实践" icon="book-open" href="/build/core-features/common/user/xuser_howto_best_practice_signing_in">
    游戏需要建立一个初始用户。
  </Card>
</CardGroup>

## 另请参阅

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


## Related topics

- [GDK 中的用户身份与 XUser API](/zh-CN/build/core-features/common/user/index.md)
- [用户身份与 XUser](/zh-CN/build/core-features/common/user/player-identity-xuser.md)
- [用户](/zh-CN/build/core-features/common/user/user-toc.md)
- [账户身份验证和访问概述](/zh-CN/services/xbox-services/fundamentals/identity/auth/live-authentication-overview.md)
- [如何:登录用户的最佳实践](/zh-CN/build/core-features/common/user/xuser_howto_best_practice_signing_in.md)