Skip to main content

トーナメントとリーダーボードのクイックスタート

このクイックスタートでは、プレイヤーのハイスコアを追跡する統計を用意する方法と、上位のハイスコアのリーダーボードを取得する方法について説明します。これはグローバル リーダーボードで利用したり、リセット可能な統計 と組み合わせて、特定のイベントやトーナメントのためにリセットしたりできます。

前提条件

プレイヤーが既に PlayFab にログインしていること。

ステップ 1 - 統計と関連するリーダーボードを作成する

Game Manager で:
  • 左側のメニューから Leaderboards に移動します。
  • NEW LEADERBOARD を選択します。
  • Statistic name フィールドに HighScore という Leaderboard を追加します。
  • 提供されているドロップダウン メニューを使用して、Reset frequency フィールドを Manually に設定します。
  • Aggregation method フィールドに移動し、提供されているドロップダウン メニューから Maximum (常に最高値を使用) を選択します。

ステップ 2 - プレイヤーのハイスコアで統計を更新する

クライアントから UpdatePlayerStatistics を使用する前に、API Features で有効にする必要があります。
  1. タイトルの Settings メニューから Title settings を選択します。
  2. API Features タブを選択します。
  3. Allow client to post player statistics のチェック ボックスをオンにします。 注: 一般に、このオプションはライブ ゲームでは使用しないでください。送信される値に対する権限がクライアントに与えられるためです。これは、プレイヤーが統計を不正操作する懸念がない場合にのみ有効です。統計をセキュアに保つ必要がある場合は、Cloud Script やカスタム ゲーム サーバーなど、サーバー主導の操作でのみ更新する必要があります。
  4. 画面下部にある SAVE を選択します。

C# コード例 - SubmitScore

このコード例では、ゲーム終了時に呼び出される SubmitScore 関数を用意します。

ステップ 3 - ハイスコアのリーダーボードをリクエストする

ゲームをプレイしたすべてのプレイヤーの上位ハイスコアのリーダーボードを取得するには、GetLeaderboard を呼び出します。

C# コード例 - RequestLeaderboard

このコード例では、リーダーボードを取得するために呼び出される RequestLeaderboard 関数を用意し、その結果を DisplayLeaderboard 関数に渡します。この関数は、ゲーム内でハイスコアを表示する体験を構築します。
最終更新日 2026年8月13日