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

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

• 現在ゲーム内にいるユーザーの一覧
• 現在のユーザーの People のうちオンラインのユーザーの一覧
• ランダムなユーザーを含むグローバル リーダーボード
• ユーザーの People のリーダーボード

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

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

エクスペリエンスにユーザーの一覧をレンダリングするには、複数のサービスを呼び出す必要があります。これは、表示名とゲーマータグの情報は Profile サービス 以外のサービスからは決して返されないためです。 サービス API の一般的な呼び出しパターンは、まずリストを最も適切にフィルターまたはソートできるサービスから XUID のリストを取得するために 1 回のラウンドトリップを行い、次に必要に応じて各 XUID に必要な追加メタデータを取得するために他のサービスへの同時ラウンドトリップ呼び出しを行うことです。 画像については、画像 URL から画像を取得するために 3 回目のラウンドトリップ呼び出しが必要になる場合があります。 ユーザーのピープル リストに関するデータを取得するために必要なラウンドトリップの回数を減らすため、関連するサービスに People モニカー が導入されました。 この機能により、呼び出し元は、プライマリ サービスに対して People サービスからユーザーのピープル リストを取得し、その XUID のセットを使用して戻り値のスコープを絞り込むよう抽象的に指示できます。 このトピックの先頭へ戻る。

​

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

タイトルが持っているもの: ゲーム内にいる他のユーザーのランダムな XUID のリスト。 目標: 他の各ユーザーの最小限の情報をレンダリングすること。 レンダリングするフィールド [所有サービス]: GameDisplayName [Profile] 呼び出しフロー: XUID のリストを指定して Profile を呼び出します。 このトピックの先頭へ戻る。

​

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

タイトルが持っているもの: 現在のユーザーの XUID。 目標: 現在のユーザーのピープル リストに含まれるオンライン ユーザーの豊富なリストをレンダリングすること。 レンダリングするフィールド [所有サービス]:

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

呼び出しフロー:

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

このトピックの先頭へ戻る。

​

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

タイトルが持っているもの: リーダーボードの ID / 名前。 目標: リーダーボード上の各ユーザーの基本情報をレンダリングすること。 レンダリングするフィールド [所有サービス]:

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

呼び出しフロー:

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

このトピックの先頭へ戻る。

​

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

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

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

目標: リーダーボード上の各ユーザーの基本情報をレンダリングすること。 レンダリングするフィールド [所有サービス]:

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

呼び出しフロー:

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

このトピックの先頭へ戻る。