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

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

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

版本 2.0，10/01/2024

在 XBOX 主機上，遊戲必須使用玩家代號作為其主要顯示名稱。

遊戲可以根據設計選擇，在玩家的新式玩家代號或傳統玩家代號之間擇一使用。新式玩家代號可在 GDK 中使用，而傳統玩家代號則可在 ERA 和 GDK 中使用。

在非主機平台上，雖然並非必要，但我們建議您在遊戲體驗中的適當位置使用 XBOX 網路玩家的玩家代號。

玩家代號必須根據所使用的玩家代號類型，在遊戲中正確顯示：

**新式玩家代號**<br />顯示唯一新式玩家代號的全部 16 個字元，其中包括最多 12 個字元的新式玩家代號，後面接著 # 和尾碼數字 (若有)。例如：Major Nelson (無尾碼) 或 Major Nelson#881。如果使用新式玩家代號，則必須支援新式玩家代號可用的所有 Unicode 字元範圍。如需更多新式玩家代號資訊和最佳做法，請參閱 GDK 開發文件文章「新式玩家代號概觀」。

**傳統玩家代號**<br />正確顯示傳統玩家代號的全部 15 個字元。傳統玩家代號只包含 ASCII 字元 a-z、A-Z、0-9、逗號 (,) 和空格 (ASCII 字元 0x20)。例如：Major Nelson

在 GDK 中，這些項目是使用 [XUserGetGamertag](/zh-TW/reference/system/xuser/functions/xusergetgamertag) API 傳回。在 ERA 中，則是使用 `GetUserProfileAsync` API 取得玩家代號。

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

## 認證測試案例

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

**所需工具**

* GDK 中的 *XblTestAccountGui.exe*

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

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

**測試步驟**

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

**預期結果**<br />使用者的玩家代號必須正確顯示。

**通過範例**

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

**失敗範例**

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


## Related topics

- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)
- [Beta 版與 XBOX Game Preview 遊戲產品的需求](/zh-TW/publishing/certification/cert-beta-game-preview.md)
- [XR046 顯示名稱與玩家圖片](/zh-TW/publishing/certification/fma/xr-046.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XBOX 需求與原則支援內容](/zh-TW/publishing/certification/xr/overview.md)