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

# Rich Presence 字串的原則和限制

> XBOX Live Rich Presence 字串的規則，包括 44 個字元的限制、字串集需求、列舉、統計資料和易記名稱語法。

本主題說明 Rich Presence 字串的原則和限制。當您為遊戲實作 Rich Presence 時，必須遵守下列原則和限制。

* 每個遊戲都必須至少有一個字串集，但您可以擁有的字串集數量沒有上限。

* 您必須為每個列舉和每個 Rich Presence 字串定義預設字串和文化特性中性字串。

* 您可以使用數值或字串統計資料來填入字串中的參數。您不能使用 `DateTime` 統計資料。

* 如果您在 Rich Presence 字串中使用統計資料，這些統計資料 (包括統計資料的任何列舉) 必須在相同的服務設定識別碼 (SCID) 和沙箱中可用。

* 您總共有 1 行 44 個字元 (包括參數的值)。這與 XBOX 360 Rich Presence 的限制類似。
  * 必須使用 Unicode 字元，且必須能夠搭配 UTF-8 編碼進行顯示。

* 您的易記名稱必須遵循下列規則。
  * 允許的字元為 "A" 到 "Z"、"a" 到 "z"、底線 (\_)，以及 "0" 到 "9"。沒有字元數限制。

* 不會對您的字串進行任何字串驗證。您必須自行進行任何字串驗證，例如檢查拼字，以及確認字串已正確當地語系化。
  * 如果我們判定某個字串集不適當 (例如包含辱罵或冒犯性語言)，我們會禁止遊戲使用 Rich Presence，直到這些字串更新至令我們滿意為止。

* 如果您的遊戲未與 XBOX Live 玩家資料整合，就沒有在字串中使用統計資料作為參數的選項。
  * 在此情況下，所有字串都必須完全預先定義 (不允許任何權杖)。

* 列舉名稱在所有列舉之間必須是唯一的，且不得與統計資料名稱重複。

* 如果某一行超過可顯示的字元數，且有換行符號，該行會自動截斷。


## Related topics

- [Rich Presence 概念](/zh-TW/services/xbox-services/community/presence/concepts/live-presence-concepts-nav.md)
- [概念](/zh-TW/services/xbox-services/community/presence/concepts/index.md)
- [設定 Rich Presence 字串](/zh-TW/services/xbox-services/community/presence/config/live-presence-config.md)
- [Rich Presence](/zh-TW/services/xbox-services/community/presence/live-presence-nav.md)
- [在 Partner Center 中設定 Rich Presence 字串](/zh-TW/services/xbox-services/community/presence/config/live-presence-config2.md)