> ## 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 字串集，以產生動態活動文字。

本文說明如何設定 Rich Presence 字串。

## 字串

對於您的 Rich Presence 字串，您必須定義字串集。
建議您為每個字串集提供易記名稱作為識別碼。

您建立的每個字串集都必須包含一組字串，並針對遊戲將發行的地區設定適當地當地語系化。

除了當地語系化字串之外，您也必須提供文化特性中性字串。
如果要求的地區設定不存在，就會使用此字串。

每個字串集也可以透過將字串參數化來使用遊戲內資料，以進一步增強字串。
只要產生的字串不超過字元限制，字串集就可以有任意數量的參數。如需詳細資訊，請參閱 [Rich Presence 字串的原則和限制](/zh-TW/services/xbox-services/community/presence/concepts/live-presence-limits)。

## 列舉

下列所述的列舉是透過 XBOX 玩家資料中的事件來定義的。

## 統計資料

您可以在 Rich Presence 字串中使用以事件為基礎的數值統計資料值。
例如，在射擊遊戲中，您可能會想要讓 Rich Presence 字串顯示玩家目前的擊殺數。

設定需要指出參數會被 "Kill Count" 統計資料取代。
它是透過通用結構描述事件系統建立的，並傳遞或轉送至 XBOX Player Stats 服務以轉換成玩家資料。統計資料必須使用統計資料設定來定義。

當其他玩家讀取字串時，Rich Presence 服務會擷取 "Kill Count" 統計資料的最新值。因此，字串一律是最新的。

包含變數的 Rich Presence 字串只與以事件為基礎的數值統計資料相容，與遊戲管理的統計資料不相容。

## 狀態

您也可以選擇在 Rich Presence 字串中使用代表實際狀態值的統計資料。
例如，在賽車遊戲中，您可以使用 Rich Presence 字串來顯示玩家目前駕駛的是哪部車，或玩家正在哪張地圖或哪條賽道上比賽。

**設定狀態資訊**

1. 為任何遊戲內字串定義列舉。例如，如果您的遊戲中有五張地圖，而您希望這些地圖成為 Rich Presence 字串的一部分，則這五張地圖也需要列舉成當地語系化字串。

2. 將列舉連結至統計資料。Rich Presence 服務會再次透過查閱統計資料的值，從玩家資料擷取最新的值。然後，服務會判斷統計資料對應到哪個列舉值。

## 範例遊戲

在本範例的其餘部分中，假設您正在開發最新的踢水桶遊戲。您想要為每種被踢的水桶類型建立統計資料，然後使用 Rich Presence 字串顯示統計資料。

假設遊戲規則如下：

* 水桶類型為木頭、銀和金。

* 地點為山區、沙漠和海灘。

* 水桶被踢時會碎裂。玩家必須一直尋找更多水桶。

* 有些水桶需要特殊裝備才能成功踢開。例如，靴子必須夠堅固才能承受一踢。

* 遊戲有多人遊戲模式。如果有足夠的玩家同時嘗試踢同一個水桶，就不需要特定的靴子。

此遊戲的 Rich Presence 字串設定如下所示。

## 設定 Rich Presence 的統計資料

若要在 Rich Presence 字串中使用由 XBOX 玩家資料產生的統計資料，請提供 Rich Presence 服務的名稱。

## 列舉設定範例

以下是定義幾個列舉的範例。

1. 為遊戲中的地圖建立列舉。遊戲有三張地圖。每張地圖都有易記名稱，以便輕鬆參考。

2. 為每個地區設定建立該地圖名稱的當地語系化字串。請注意，有一個整體預設當地語系化和一個文化特性中性的當地語系化。

3. 考慮遊戲中的三種武器。它們都有易記名稱和當地語系化字串。這適用於所有列舉。

| 列舉 | 相關統計資料 | 易記名稱 | 地區設定 | 字串 |
| - | - | - | - | - |
| Map | CurrentMap | Map\_Mountains | 預設 | Mountains |
| | | | en | Mountains |
| | | | en-US | Mountains |
| | | | en-GB | Mountains |
| | | | de-DE | Gebirge |
| | | | 其他地區設定 | |
| | | Map\_Desert | 預設 | Desert |
| | | | en | Desert |
| | | | en-US | Desert |
| | | | en-GB | Desert |
| | | | de-DE | Wuste |
| | | | 其他地區設定 | |
| | | Map\_Beach | 預設 | Beach |
| | | | en | Beach |
| | | | en-US | Beach |
| | | | en-GB | Beach |
| | | | de-DE | Strand |
| | | | 其他地區設定 | |
| Boot | CurrentWeapon | Boot\_Light | 預設 | Light |
| | | | en | Light |
| | | | en-US | Light |
| | | | en-GB | Light |
| | | | de-DE | Leicht |
| | | | 其他地區設定 | |
| | | Boot\_Medium | 預設 | Medium |
| | | | en | Medium |
| | | | en-US | Medium |
| | | | en-GB | Medium |
| | | | de-DE | Mittel |
| | | | 其他地區設定 | |
| | | Boot\_Strong | 預設 | Strong |
| | | | en | Strong |
| | | | en-US | Strong |
| | | | en-GB | Strong |
| | | | de-DE | Stark |
| | | | 其他地區設定 | |

## 字串設定範例

現在列舉和統計資料都已定義，請建立您的字串。

在下列範例表格中，第一欄是易記名稱，可協助區分不同的字串集。
在此範例中，第一個字串集使用字串 "playingMap"，第二個使用 "totalKicked"，第三個使用 "multiplayer"。

### 地區設定-字串配對

接下來的兩欄是一起使用的。
它們是 Rich Presence 字串的地區設定-字串配對。

在第一個範例中，使用的是英文字串 "Playing on {0}"。
{0} 權杖會被某個值取代。

然後，字串會針對其他地區設定進行當地語系化。

就像在列舉中一樣，必須有預設字串和文化特性中性字串。當玩家使用您未指定地區設定-字串配對的地區設定時，就會使用這些字串。
用於列舉的地區設定必須與字串的地區設定相符。

### 用於建構字串的參數

最後一欄是用來填入 Rich Presence 字串中空白的參數。

如果您希望 Presence 服務在 Statistics 服務中查閱參數的值，就必須在此使用統計資料名稱來參考參數。
在字串中使用統計資料可讓您只需設定一次。您不需要重寫它們。

如果您的字串中有地圖名稱，而且您使用 `CurrentMap` 統計資料來填入空白，則當玩家在遊戲中從一張地圖移動到另一張地圖時，Rich Presence 服務會適當地更新您的字串。
如果您未在 Rich Presence 字串中使用統計資料，就無法指定任何參數。

在下列範例表格中，第一個字串使用由統計資料產生的目前地圖。第二個字串使用 `BucketsKicked` 統計資料。

第三個範例不包含參數。
該字串是獨立定義的；它不參考統計資料。

| 易記名稱 | 地區設定 | 字串 | 參數 |
| - | - | - | - |
| playingMap | 預設 | Playing on map:{0} | CurrentMap |
| | en | | Playing on map:{0} |
| | en-US | | Playing on map:{0} |
| | en-GB | | Playing on map:{0} |
| | de-DE | | Auf der Karte spielen:{0} |
| | 其他地區設定 | | |
| totalKicked | 預設 | Kicked {0} Buckets! | BucketsKicked |
| | en | | Kicked {0} Buckets! |
| | en-US | | Kicked {0} Buckets! |
| | en-GB | | Kicked {0} Buckets! |
| | de-DE | | {0} getretenen Eimer! |
| | 其他地區設定 | | |
| multiplayer | 預設 | Playing multiplayer | |
| | en | | Playing multiplayer |
| | en-US | | Playing multiplayer |
| | en-GB | | Playing multiplayer |
| | de-DE | | Mehrspieler spielen |
| | 其他地區設定 | | |

您可以建立的字串數量沒有限制，但您的遊戲必須至少有一個字串。

`BucketsKicked` 只是在您的字串中被取代的數字。
`CurrentMap` 是字串來自列舉之統計資料的範例。
當您的遊戲將 Rich Presence 設定為其中一個字串時，請使用設定來了解需要哪些參數。


## Related topics

- [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)
- [Rich Presence 入口網站設定](/zh-TW/services/xbox-services/community/presence/config/live-presence-config-nav.md)
- [入口網站設定概觀](/zh-TW/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
- [透過 REST 更新使用者的線上狀態](/zh-TW/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)