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

# 丰富在线状态概述

> XBOX 服务 Rich Presence 简介，介绍游戏如何在默认的 Basic Presence 之外通告玩家的当前活动和位置。

本主题概述 Rich Presence。它显示玩家在游戏中正在做什么以及所在位置。

默认情况下，游戏具有 *Basic Presence*。这向其他玩家表明玩家正在玩哪款游戏。
如果你编写代码来使用 *Rich Presence*，Rich Presence 字符串还应能够表明玩家正在做什么以及玩家在游戏中的位置。Rich Presence 信息对连接到 XBOX 网络的玩家可见。

通过使用 Rich Presence，你的游戏可以通告玩家的活动和位置。
例如，你的游戏可以使用这些字符串向所有玩家显示游戏中玩家的状态（如离开）。

> [!NOTE]
>
> XBOX 服务的 Rich Presence 字符串功能中，游戏的名称由 Microsoft Store 中该游戏的商店信息控制。目前，无论你当前在哪个沙盒中测试，Rich Presence 中显示的游戏名称都来自 RETAIL 目录。如果你的游戏信息尚未发布到 RETAIL 商店，你的游戏名称在 XBOX UI 中的 Rich Presence 字符串中可能显示为 “Home”。

本节中的主题描述了如何执行以下操作：

* 配置 Rich Presence 字符串。
* 为正在玩你游戏的玩家设置字符串。

## 定义

以下是本节中使用的一些术语。

* **枚举 (Enumeration):**
  枚举是一些游戏内维度的列表。
  例如，武器、角色职业和地图。
  对于这些示例，你可以显示游戏中可能武器的列表以及所有可能的角色职业或地图的列表。

* **区域设置-字符串对 (Locale-string pair):**
  区域设置-字符串对指定字符串可以或应该在哪些区域设置中使用。每个可能的 Rich Presence 字符串必须与一个区域设置关联。
  每个枚举也有一组区域设置-字符串对。

* **字符串集 (String-set):**
  字符串集由一组区域设置-字符串对组成。
  此集合定义所有可能区域设置下 Rich Presence 字符串的可能值，或所有可能区域设置下枚举的可能值。

* **友好名称 (Friendly name):**
  有两种类型的友好名称。

  * **Rich Presence 字符串：** 字符串集的友好名称是一种字符串形式的唯一标识符，用于引用字符串集。
  * **枚举：** 这些友好名称用于唯一标识特定枚举，例如武器枚举或角色职业枚举。

## 后续步骤

* [如何使用 XBOX 服务 API](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/xbox-services-api/live-gs-xbl-apis.md)：初始化 XBOX Services API (XSAPI)，并创建 Rich Presence 调用所需的 XBOX 服务上下文。
* [通过 XSAPI C 更新用户的在线状态](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/how-to/live-updating-user-presence.md)：通过调用 `XblPresenceSetPresenceAsync` 设置玩家的 Rich Presence 字符串。


## Related topics

- [在合作伙伴中心配置丰富在线状态字符串](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/config/live-presence-config2.md)
- [丰富在线状态概念（目录）](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/concepts/live-presence-concepts-nav.md)
- [丰富在线状态（目录）](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/live-presence-nav.md)
- [丰富在线状态附录](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/concepts/live-presence-apx.md)
- [丰富在线状态门户配置（目录）](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/config/live-presence-config-nav.md)