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

# Rich Presence 概觀

> XBOX Live Rich Presence 簡介，說明遊戲如何在預設的基本線上狀態之外，宣傳玩家目前的活動和位置。

本主題提供 Rich Presence 的概觀。它會顯示玩家正在做什麼，以及他們在遊戲中的位置。

根據預設，遊戲具有*基本線上狀態*。這會向其他玩家指出某位玩家正在玩哪個遊戲。
如果您撰寫程式碼來使用 *Rich Presence*，Rich Presence 字串最好也能指出玩家正在做什麼，以及他們在遊戲中的位置。已連線至 XBOX Live 的玩家都可以看到 Rich Presence 資訊。

透過使用 Rich Presence，您的遊戲可以宣傳玩家的活動和位置。
例如，您的遊戲可以使用這些字串向所有玩家顯示您遊戲之玩家的狀態 (例如離開)。

> [!NOTE]
>
> XBOX 服務 Rich Presence 字串功能中的遊戲名稱是由遊戲的 Microsoft Store 清單所控制。目前，無論您目前在哪個沙箱中進行測試，Rich Presence 的遊戲名稱都來自 RETAIL 目錄。如果您遊戲的資訊尚未發佈至 RETAIL 市集，您遊戲的名稱可能會在 XBOX UI 的 Rich Presence 字串中顯示為 'Home'。

本節中的主題說明如何執行下列動作：

* 設定您的 Rich Presence 字串。
* 為正在玩您遊戲的玩家設定字串。

## 定義

以下是本節中使用的一些詞彙。

* **列舉：**
  列舉是某個遊戲內維度的清單。
  例如武器、角色職業和地圖。
  在這些範例中，您可以顯示遊戲中可能武器的清單，以及所有可能角色職業或地圖的清單。

* **地區設定-字串配對：**
  地區設定-字串配對會指定可以或應該使用該字串的地區設定。每個可能的 Rich Presence 字串都必須有相關聯的地區設定。
  每個列舉也都有一組地區設定-字串配對。

* **字串集：**
  字串集由一組地區設定-字串配對組成。
  此集合定義了 Rich Presence 字串在所有可能地區設定中的可能值，或列舉在所有可能地區設定中的可能值。

* **易記名稱：**
  易記名稱有兩種類型。

  * \*\*Rich Presence 字串：\*\*字串集的易記名稱是字串形式的唯一識別碼，用來參考字串集。
  * \*\*列舉：\*\*這些易記名稱用來唯一識別特定列舉，例如武器列舉或角色職業列舉。


## Related topics

- [Rich Presence (內容)](https://docs.xbox.com/zh-TW/services/xbox-services/community/presence/live-presence-nav.md)
- [在 Partner Center 中設定 Rich Presence 字串](https://docs.xbox.com/zh-TW/services/xbox-services/community/presence/config/live-presence-config2.md)
- [透過 XSAPI C 更新使用者的線上狀態](https://docs.xbox.com/zh-TW/services/xbox-services/community/presence/how-to/live-updating-user-presence.md)
- [社交功能概觀](https://docs.xbox.com/zh-TW/services/xbox-services/community/live-social-overview.md)
- [Rich Presence 附錄](https://docs.xbox.com/zh-TW/services/xbox-services/community/presence/concepts/live-presence-apx.md)