Skip to main content
PlayFab では通常、次の API メソッドを使用してリーダーボードを構築します: 結果は、プレイヤーに関する基本的な情報と、現在のリーダーボードとの関係のみを含む PlayerLeaderboardEntry オブジェクトのリストです。 ただし、PlayFab では PlayerProfileViewConstraints を使用して、各プレイヤーに関する追加情報を取得することもできます。
この例では、既にリーダーボード データがあることを前提としています。テスト データを生成する方法については、アーカイブされたトーナメントの結果へのアクセス チュートリアルを参照してください。

プレイヤー プロファイル ビュー制約の構成

デフォルトでは、クライアント API は他のプレイヤー プロファイルから表示名のみを取得できます。この例では、リーダーボード内の 他の プレイヤーに関する追加情報に すべての プレイヤーがアクセスできるようにします。 タイトルの Game Manager に移動します:
  1. 左のメニューから Settings アイコンを選択します。
  2. Title settings を選択します。
  3. 次に Client Profile Options タブを選択します。
  4. DisplayName が選択されていることを確認します。
  5. Avatar URL が選択されていることを確認します。
  6. Save Client Profile Options ボタンを選択して変更を送信します。
Game Manager - Settings - Client Profile Options

テスト

前のステップにより、クライアント コードで DisplayName および AvatarUrl プロファイル制約を使用できるようになりました。 次のサンプルは、上記のプロファイル データを使用してリーダーボードを取得して表示する方法を示しています。詳細については、コード コメントを参照してください。
個々のプロファイル フィールドは、クライアントがプロファイル制約を使用して明示的に要求した場合 のみ 利用可能です。また、特定のプロファイル制約が Game Manager で許可されて いない 場合にクライアントがそれらを要求すると、API 呼び出しは対応するエラーで失敗することにも注意してください。結果は、以下の例のようになります。
Output - Display Leaderboard この手法を使用すると、他の統計値を含む、少数のプロファイル情報を取得できます。
最終更新日 2026年8月13日