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

# ピープル システムからのユーザー表示

> People、Presence、Profile、Leaderboards の各サービスを People モニカーと組み合わせて、XBOX Live のピープル リスト データを表示する呼び出しパターンについて説明します。

<a id="top" />

このトピックでは、ピープル システムを使用してユーザーを表示するためのコード フローについて説明します。以下に、タイトルが People に関連するサービスからデータを取得する呼び出しフローの例を示します。

* [現在ゲーム内にいるユーザーの一覧](#loucig)
* [現在のユーザーの People のうちオンラインのユーザーの一覧](#lotcupwao)
* [ランダムなユーザーを含むグローバル リーダーボード](#glcru)
* [ユーザーの People のリーダーボード](#loup)

XBOX Live 全体のサービスは、そのサービスが所有するデータのみを返し、ユーザーへの参照としては XUID のみを返します。
以下にいくつかの例を示します。

* *People サービス* は、ユーザーのピープル リストにある XUID と、それらの XUID に関する非常に基本的な情報 (お気に入りステータスなど) のみを所有し返します。
* *Presence サービス* は、XUID のオンライン ステータス情報に関するデータを所有します。
* *Leaderboards サービス* は、XUID のリストのランキング情報を所有します。

エクスペリエンスにユーザーの一覧をレンダリングするには、複数のサービスを呼び出す必要があります。これは、表示名とゲーマータグの情報は *Profile サービス* 以外のサービスからは決して返されないためです。

サービス API の一般的な呼び出しパターンは、まずリストを最も適切にフィルターまたはソートできるサービスから XUID のリストを取得するために 1 回のラウンドトリップを行い、次に必要に応じて各 XUID に必要な追加メタデータを取得するために他のサービスへの同時ラウンドトリップ呼び出しを行うことです。
画像については、画像 URL から画像を取得するために 3 回目のラウンドトリップ呼び出しが必要になる場合があります。

ユーザーのピープル リストに関するデータを取得するために必要なラウンドトリップの回数を減らすため、関連するサービスに People *モニカー* が導入されました。
この機能により、呼び出し元は、プライマリ サービスに対して People サービスからユーザーのピープル リストを取得し、その XUID のセットを使用して戻り値のスコープを絞り込むよう抽象的に指示できます。

[このトピックの先頭へ戻る。](#top)

<a id="loucig" />

## 現在ゲーム内にいるユーザーの一覧

**タイトルが持っているもの:**

ゲーム内にいる他のユーザーのランダムな XUID のリスト。

**目標:**

他の各ユーザーの最小限の情報をレンダリングすること。

**レンダリングするフィールド \[所有サービス]:**

`GameDisplayName` \[Profile]

**呼び出しフロー:**

XUID のリストを指定して `Profile` を呼び出します。

[このトピックの先頭へ戻る。](#top)

<a id="lotcupwao" />

## 現在のユーザーの People のうちオンラインのユーザーの一覧

**タイトルが持っているもの:**

現在のユーザーの XUID。

**目標:**

現在のユーザーのピープル リストに含まれるオンライン ユーザーの豊富なリストをレンダリングすること。

**レンダリングするフィールド \[所有サービス]:**

* お気に入りインジケーター \[People]
* 表示画像 \[Profile]
* `GameDisplayName` \[Profile]
* 基本的なオンライン ステータス (緑色の丸) \[Presence]

**呼び出しフロー:**

1. `Presence` を呼び出し、`People` モニカーを渡して、ユーザーの各 People の XUID とオンライン ステータスを取得します。
2. 並行して:
   1. `Profile` を呼び出し、XUID のリスト全体を渡して、各表示名と画像 URL を取得します。次に、各画像 URL から画像を取得します。
   2. `People` を呼び出し、XUID のリストを渡して、いずれかがユーザーのお気に入りかどうかを確認します。

[このトピックの先頭へ戻る。](#top)

<a id="glcru" />

## ランダムなユーザーを含むグローバル リーダーボード

**タイトルが持っているもの:**

リーダーボードの ID / 名前。

**目標:**

リーダーボード上の各ユーザーの基本情報をレンダリングすること。

**レンダリングするフィールド \[所有サービス]:**

* お気に入りインジケーター \[People]
* `GameDisplayName` \[Profile]
* ランク \[Leaderboards]
* スコア \[Leaderboards]

**呼び出しフロー:**

1. `Leaderboards` を呼び出して、特定のリーダーボードの XUID、ランク、スコアを取得します。
2. 並行して:
   * `Profile` を呼び出し、XUID のリストを渡して、各表示名と画像 URL を取得します。
   * `People` を呼び出し、XUID のリストを渡して、いずれかがユーザーのお気に入りかどうかを確認します。

[このトピックの先頭へ戻る。](#top)

<a id="loup" />

## ユーザーの People のリーダーボード

**タイトルが持っているもの:**

* リーダーボードの ID / 名前
* 現在のユーザーの XUID

**目標:**

リーダーボード上の各ユーザーの基本情報をレンダリングすること。

**レンダリングするフィールド \[所有サービス]:**

* お気に入りインジケーター \[People]
* `GameDisplayName` \[Profile]
* ランク \[Leaderboards]
* スコア \[Leaderboards]

**呼び出しフロー:**

1. `Leaderboards` を呼び出し、`People` モニカーを渡して、ユーザーのピープル リストに限定された特定のリーダーボードの XUID、ランク、スコアを取得します。
2. 並行して:
   * `Profile` を呼び出し、XUID のリストを渡して、各表示名と画像 URL を取得します。
   * `People` を呼び出し、XUID のリストを渡して、いずれかがユーザーのお気に入りかどうかを確認します。

[このトピックの先頭へ戻る。](#top)


## Related topics

- [ピープル システム (フレンド リスト) の概念](/ja-jp/services/xbox-services/community/people-system/concepts/live-people-system-concepts-nav.md)
- [概念](/ja-jp/services/xbox-services/community/people-system/concepts/index.md)
- [ピープル システム (フレンド リスト) の概要](/ja-jp/services/xbox-services/community/people-system/live-people-system-overview.md)
- [ピープル システム (フレンド リスト) のサンプル コード](/ja-jp/services/xbox-services/community/people-system/how-to/live-pplsys-howto-nav.md)
- [ピープル システム](/ja-jp/services/xbox-services/community/people-system/index.md)