XR-046 顯示名稱與玩家圖片

版本 2.0，10/01/2024 在 XBOX 主機上，遊戲必須使用玩家代號作為其主要顯示名稱。 遊戲可以根據設計選擇，在玩家的新式玩家代號或傳統玩家代號之間擇一使用。新式玩家代號可在 GDK 中使用，而傳統玩家代號則可在 ERA 和 GDK 中使用。 在非主機平台上，雖然並非必要，但我們建議您在遊戲體驗中的適當位置使用 XBOX 網路玩家的玩家代號。 玩家代號必須根據所使用的玩家代號類型，在遊戲中正確顯示： 新式玩家代號
顯示唯一新式玩家代號的全部 16 個字元，其中包括最多 12 個字元的新式玩家代號，後面接著 # 和尾碼數字 (若有)。例如：Major Nelson (無尾碼) 或 Major Nelson#881。如果使用新式玩家代號，則必須支援新式玩家代號可用的所有 Unicode 字元範圍。如需更多新式玩家代號資訊和最佳做法，請參閱 GDK 開發文件文章「新式玩家代號概觀」。 傳統玩家代號
正確顯示傳統玩家代號的全部 15 個字元。傳統玩家代號只包含 ASCII 字元 a-z、A-Z、0-9、逗號 (,) 和空格 (ASCII 字元 0x20)。例如：Major Nelson 在 GDK 中，這些項目是使用 XUserGetGamertag API 傳回。在 ERA 中，則是使用 GetUserProfileAsync API 取得玩家代號。

[!Note] 泰文和天城文都是新式玩家代號支援的語言，其所需的 Unicode 變音符號支援經常引發問題，而這些問題往往要到測試後期才會被發現。如果您打算在遊戲中支援新式玩家代號，請及早規劃並測試這些語言的字元。

​

認證測試案例

​

046-01 顯示名稱與玩家圖片

所需工具

• GDK 中的 XblTestAccountGui.exe

準備
針對下列每個名稱建立四個測試帳戶，並使用 XblTestAccountGui.exe 將每個測試帳戶的玩家代號變更為下列名稱：

• สฐ众нь컴퓨퓨
• आथाώঙぁヺ
• øÜêþЯЂў
• gttest1

測試步驟

1. 找出並檢視遊戲中顯示玩家代號的位置。
2. 檢查使用者的玩家代號在步驟 [1] 中找出的所有區域中如何顯示。
3. 如果遊戲會顯示使用者的圖片，請確認每個帳戶都顯示正確的 Microsoft 帳戶圖片或玩家圖片。

預期結果
使用者的玩家代號必須正確顯示。 通過範例

1. 使用新式玩家代號時，玩家代號正確顯示 Unicode 字元 (包括自動產生的尾碼)。
2. 使用傳統玩家代號時，玩家代號正確顯示。

失敗範例

1. 由於 Unicode 字元顯示為空白字元，玩家代號完全無法呈現。
2. 使用傳統玩家代號時，玩家代號未正確顯示。