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

# リッチ プレゼンスの概要

> 既定の基本プレゼンスを超えて、タイトルがプレイヤーの現在のアクティビティや場所を広告する方法を説明する XBOX Live リッチ プレゼンスの概要です。

このトピックでは、リッチ プレゼンスの概要を説明します。リッチ プレゼンスは、プレイヤーがゲーム内で何をしていて、どこにいるかを示します。

既定では、ゲームは *基本プレゼンス* を持ちます。これは、プレイヤーがどのゲームをプレイしているかを他のプレイヤーに示します。
*リッチ プレゼンス* を使用するコードを記述すると、理想的にはリッチ プレゼンス文字列もプレイヤーがゲーム内で何をしていて、どこにいるかを示します。リッチ プレゼンス情報は、XBOX Live に接続しているプレイヤーに表示されます。

リッチ プレゼンスを使用することで、ゲームはプレイヤーのアクティビティと場所を広告できます。
たとえば、これらの文字列を使って、ゲームのプレイヤーのステータス (退席中など) をすべてのプレイヤーに表示できます。

<Note>XBOX services のリッチ プレゼンス文字列機能におけるゲームのタイトルは、そのゲームの Microsoft Store 掲載情報によって制御されます。現時点では、リッチ プレゼンスのタイトル名は、現在テストしているサンドボックスに関係なく、RETAIL カタログから取得されます。タイトルの情報がまだ RETAIL ストアに公開されていない場合、XBOX UI のリッチ プレゼンス文字列でタイトル名が「Home」と表示されることがあります。</Note>

このセクションのトピックでは、以下を行う方法を説明します。

* リッチ プレゼンス文字列を構成する。
* ゲームをプレイしているプレイヤーの文字列を設定する。

## 定義

このセクションで使用される用語をいくつか紹介します。

* **列挙:**
  列挙は、ゲーム内のあるディメンションのリストです。
  たとえば、武器、キャラクター クラス、マップなどです。
  これらの例では、ゲーム内の可能な武器のリストや、可能なすべてのキャラクター クラスまたはマップのリストを表示できます。

* **ロケールと文字列のペア:**
  ロケールと文字列のペアは、文字列を使用できる、または使用すべきロケールを指定します。すべての可能なリッチ プレゼンス文字列には、関連付けられたロケールが必要です。
  各列挙にも、ロケールと文字列のペアのセットがあります。

* **文字列セット:**
  文字列セットは、ロケールと文字列のペアのグループで構成されています。
  このセットは、すべての可能なロケールに対するリッチ プレゼンス文字列の可能な値、またはすべての可能なロケールに対する列挙の可能な値を定義します。

* **フレンドリ名:**
  フレンドリ名には 2 種類あります。

  * **リッチ プレゼンス文字列:** 文字列セットのフレンドリ名は、文字列セットを参照するために使用される文字列形式の一意な識別子です。
  * **列挙:** これらのフレンドリ名は、武器の列挙やキャラクター クラスの列挙など、特定の列挙を一意に識別するために使用されます。


## Related topics

- [リッチ プレゼンス](/ja-jp/services/xbox-services/community/presence/live-presence-nav.md)
- [プレゼンス](/ja-jp/services/xbox-services/community/presence/index.md)
- [Partner Center でのリッチ プレゼンス文字列の構成](/ja-jp/services/xbox-services/community/presence/config/live-presence-config2.md)
- [XSAPI C を介したユーザーのプレゼンスの更新](/ja-jp/services/xbox-services/community/presence/how-to/live-updating-user-presence.md)
- [リッチ プレゼンスの概念](/ja-jp/services/xbox-services/community/presence/concepts/live-presence-concepts-nav.md)
