字串
對於您的 Rich Presence 字串，您必須定義字串集。 建議您為每個字串集提供易記名稱作為識別碼。 您建立的每個字串集都必須包含一組字串，並針對遊戲將發行的地區設定適當地當地語系化。 除了當地語系化字串之外，您也必須提供文化特性中性字串。 如果要求的地區設定不存在，就會使用此字串。 每個字串集也可以透過將字串參數化來使用遊戲內資料，以進一步增強字串。 只要產生的字串不超過字元限制，字串集就可以有任意數量的參數。如需詳細資訊，請參閱 Rich Presence 字串的原則和限制。列舉
下列所述的列舉是透過 XBOX 玩家資料中的事件來定義的。統計資料
您可以在 Rich Presence 字串中使用以事件為基礎的數值統計資料值。 例如，在射擊遊戲中，您可能會想要讓 Rich Presence 字串顯示玩家目前的擊殺數。 設定需要指出參數會被 “Kill Count” 統計資料取代。 它是透過通用結構描述事件系統建立的，並傳遞或轉送至 XBOX Player Stats 服務以轉換成玩家資料。統計資料必須使用統計資料設定來定義。 當其他玩家讀取字串時，Rich Presence 服務會擷取 “Kill Count” 統計資料的最新值。因此，字串一律是最新的。 包含變數的 Rich Presence 字串只與以事件為基礎的數值統計資料相容，與遊戲管理的統計資料不相容。狀態
您也可以選擇在 Rich Presence 字串中使用代表實際狀態值的統計資料。 例如，在賽車遊戲中，您可以使用 Rich Presence 字串來顯示玩家目前駕駛的是哪部車，或玩家正在哪張地圖或哪條賽道上比賽。 設定狀態資訊- 為任何遊戲內字串定義列舉。例如，如果您的遊戲中有五張地圖，而您希望這些地圖成為 Rich Presence 字串的一部分，則這五張地圖也需要列舉成當地語系化字串。
- 將列舉連結至統計資料。Rich Presence 服務會再次透過查閱統計資料的值，從玩家資料擷取最新的值。然後，服務會判斷統計資料對應到哪個列舉值。
範例遊戲
在本範例的其餘部分中，假設您正在開發最新的踢水桶遊戲。您想要為每種被踢的水桶類型建立統計資料，然後使用 Rich Presence 字串顯示統計資料。 假設遊戲規則如下：- 水桶類型為木頭、銀和金。
- 地點為山區、沙漠和海灘。
- 水桶被踢時會碎裂。玩家必須一直尋找更多水桶。
- 有些水桶需要特殊裝備才能成功踢開。例如，靴子必須夠堅固才能承受一踢。
- 遊戲有多人遊戲模式。如果有足夠的玩家同時嘗試踢同一個水桶，就不需要特定的靴子。
設定 Rich Presence 的統計資料
若要在 Rich Presence 字串中使用由 XBOX 玩家資料產生的統計資料，請提供 Rich Presence 服務的名稱。列舉設定範例
以下是定義幾個列舉的範例。- 為遊戲中的地圖建立列舉。遊戲有三張地圖。每張地圖都有易記名稱，以便輕鬆參考。
- 為每個地區設定建立該地圖名稱的當地語系化字串。請注意，有一個整體預設當地語系化和一個文化特性中性的當地語系化。
- 考慮遊戲中的三種武器。它們都有易記名稱和當地語系化字串。這適用於所有列舉。
字串設定範例
現在列舉和統計資料都已定義，請建立您的字串。 在下列範例表格中，第一欄是易記名稱，可協助區分不同的字串集。 在此範例中，第一個字串集使用字串 “playingMap”，第二個使用 “totalKicked”，第三個使用 “multiplayer”。地區設定-字串配對
接下來的兩欄是一起使用的。 它們是 Rich Presence 字串的地區設定-字串配對。 在第一個範例中，使用的是英文字串 “Playing on ”。 權杖會被某個值取代。 然後，字串會針對其他地區設定進行當地語系化。 就像在列舉中一樣，必須有預設字串和文化特性中性字串。當玩家使用您未指定地區設定-字串配對的地區設定時，就會使用這些字串。 用於列舉的地區設定必須與字串的地區設定相符。用於建構字串的參數
最後一欄是用來填入 Rich Presence 字串中空白的參數。 如果您希望 Presence 服務在 Statistics 服務中查閱參數的值，就必須在此使用統計資料名稱來參考參數。 在字串中使用統計資料可讓您只需設定一次。您不需要重寫它們。 如果您的字串中有地圖名稱，而且您使用CurrentMap 統計資料來填入空白，則當玩家在遊戲中從一張地圖移動到另一張地圖時，Rich Presence 服務會適當地更新您的字串。
如果您未在 Rich Presence 字串中使用統計資料，就無法指定任何參數。
在下列範例表格中，第一個字串使用由統計資料產生的目前地圖。第二個字串使用 BucketsKicked 統計資料。
第三個範例不包含參數。
該字串是獨立定義的；它不參考統計資料。
您可以建立的字串數量沒有限制，但您的遊戲必須至少有一個字串。
BucketsKicked 只是在您的字串中被取代的數字。
CurrentMap 是字串來自列舉之統計資料的範例。
當您的遊戲將 Rich Presence 設定為其中一個字串時，請使用設定來了解需要哪些參數。