> ## 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 表示名とゲーマー ピクチャ

> XBOX コンソール上では、タイトルは主要な表示名としてゲーマータグを使用し、モダンまたはクラシック ゲーマータグのすべての文字を正しくレンダリングする必要があります。

# XR-046: 表示名とゲーマー ピクチャ \*

Version 2.0, 2024/10/01

XBOX コンソール上では、タイトルは主要な表示名としてゲーマータグを使用する必要があります。

デザインの選択に基づき、タイトルはプレイヤーのモダン ゲーマータグまたはクラシック ゲーマータグを選択できます。モダン ゲーマータグは GDK で利用可能で、クラシック ゲーマータグは ERA と GDK の両方で利用可能です。

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

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

**モダン ゲーマータグ**

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

**クラシック ゲーマータグ**

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

GDK では、これらの項目は `XUserGetGamertag` API を使用して返されます。ERA では、ゲーマータグは `GetUserProfileAsync` API を使用して取得されます。

<Note>
  モダン ゲーマータグでサポートされている Thai と Devanagari の両言語に必要な Unicode 発音記号のサポートは、後段のテストまで検出されない問題を引き起こすことがよくあります。ゲームでモダン ゲーマータグをサポートしようとする場合は、これらの言語の文字を早期に計画してテストしてください。
</Note>

## 認定テスト ケース

### 046-01 表示名とゲーマー ピクチャ

**必要なツール**

* GDK からの `XblTestAccountGui.exe`

**準備**

以下の各名前について 4 つのテスト アカウントを作成し、各テスト アカウントのゲーマータグを `XblTestAccountGui.exe` を使用して以下に変更します。

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

**テスト ステップ**

1. タイトル内でゲーマータグが表示される場所を探して確認します。
2. ステップ 1 で特定されたすべての領域で、ユーザーのゲーマータグの表示方法を確認します。
3. タイトルがユーザーの画像を表示する場合、各アカウントに対して正しい Microsoft アカウントの画像またはゲーマー ピクチャが表示されることを検証します。

**期待される結果**

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

**合格例**

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

**不合格例**

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


## Related topics

- [FMA: XR-046 表示名とゲーマー画像](/ja-jp/publishing/certification/fma/xr-046.md)
- [後方互換性とゲーマータグの変換](/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-modern-backwards-compatibility.md)
- [PC およびモバイル認定要件および失敗の多いテスト](/ja-jp/publishing/certification/pc-certification.md)
- [XUserGamerPictureSize](/ja-jp/reference/system/xuser/enums/xusergamerpicturesize.md)
- [ゲーマータグの概要](/ja-jp/services/xbox-services/fundamentals/identity/user-profile/gamertags/live-gamertags-overview.md)