> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XR-046 表示名とゲーマー アイコン

> XBOX 本体でモダンまたはクラシック ゲーマータグをプライマリ表示名として表示する方法と、ゲーマータグとゲーマー アイコンに関する 046-01 テスト ケース。

バージョン 2.0、10/01/2024

XBOX 本体では、タイトルはゲーマータグをプライマリ表示名として使用する必要があります。

設計上の選択に基づいて、タイトルはプレイヤーのモダン ゲーマータグとクラシック ゲーマータグのどちらかを選択できます。モダン ゲーマータグは GDK で利用でき、クラシック ゲーマータグは ERA と GDK の両方で利用できます。

本体以外のプラットフォームでは、必須ではありませんが、ゲーム タイトルのエクスペリエンス内の適切な場所で XBOX network プレイヤーのゲーマータグを使用することをお勧めします。

ゲーマータグは、使用するゲーマータグの種類に応じて、タイトル内で正しく表示される必要があります。

**モダン ゲーマータグ**\
一意のモダン ゲーマータグの 16 文字すべてを表示します。これには、最大 12 文字のモダン ゲーマータグと、それに続く # とサフィックス番号 (存在する場合) が含まれます。例: Major Nelson (サフィックスなし) または Major Nelson#881。モダン ゲーマータグを使用する場合は、モダン ゲーマータグで利用可能なすべての Unicode 文字範囲をサポートする必要があります。モダン ゲーマータグの詳細とベスト プラクティスについては、GDK 開発ドキュメントの記事「モダン ゲーマータグの概要」を参照してください。

**クラシック ゲーマータグ**\
クラシック ゲーマータグの 15 文字すべてを正しく表示します。クラシック ゲーマータグには、ASCII 文字の a-z、A-Z、0-9、コンマ (,)、およびスペース (ASCII 文字 0x20) のみが含まれます。例: Major Nelson

GDK では、これらの項目は [XUserGetGamertag](https://docs.xbox.com/ja-jp/reference/system/xuser/functions/xusergetgamertag.md) API を使用して返されます。ERA では、ゲーマータグは `GetUserProfileAsync` API を使用して取得されます。

> \[!Note]
> モダン ゲーマータグでサポートされている言語であるタイ語とデーヴァナーガリー文字に必要な Unicode の発音区別符号のサポートは、テストの後半の段階まで発見されない問題を引き起こすことがよくあります。ゲームでモダン ゲーマータグのサポートを試みる場合は、これらの言語の文字について早い段階で計画とテストを行ってください。

## 認定テスト ケース

### 046-01 表示名とゲーマー アイコン

**必要なツール**

* GDK の *XblTestAccountGui.exe*

**準備**\
次の各名前について 4 つのテスト アカウントを作成し、*XblTestAccountGui.exe* を使用して各テスト アカウントのゲーマータグを次のように変更します。

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

**テスト手順**

1. タイトル内でゲーマータグが表示される場所を見つけて表示します。
2. 手順 \[1] で特定したすべての領域で、ユーザーのゲーマータグがどのように表示されるかを確認します。
3. タイトルがユーザーの画像を表示する場合は、各アカウントに対して正しい Microsoft アカウントの画像またはゲーマー アイコンが表示されることを確認します。

**期待される結果**\
ユーザーのゲーマータグが正しく表示される必要があります。

**合格例**

1. モダン ゲーマータグを使用する場合に、ゲーマータグに Unicode 文字 (自動生成されたサフィックスを含む) が正しく表示される。
2. クラシック ゲーマータグを使用する場合に、ゲーマータグが正しく表示される。

**不合格例**

1. Unicode 文字が空白文字として表示されるため、ゲーマータグがまったくレンダリングされない。
2. クラシック ゲーマータグを使用する場合に、ゲーマータグが正しく表示されない。


## Related topics

- [XBOX Requirements とポリシーのサポート コンテンツ](https://docs.xbox.com/ja-jp/publishing/certification/xr/overview.md)
- [XR046 表示名とゲーマー アイコン](https://docs.xbox.com/ja-jp/publishing/certification/fma/xr-046.md)
- [XBOX ゲーム向け XBOX 要件](https://docs.xbox.com/ja-jp/publishing/certification/xbox-requirements.md)
- [XBOX ゲーム向け認定テスト対象 XBOX 要件](https://docs.xbox.com/ja-jp/publishing/certification/console-cert-tested-requirements.md)
- [後方互換性とゲーマータグの変換](https://docs.xbox.com/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-backwards-compatibility.md)