プライズテーブルを使用する

[アーティクル]
07/12/2023

このチュートリアルでは、リセット可能なランキングのランクの範囲内にいるプレイヤーグループに対して一連のアクションをトリガーするプライズテーブルを作成する方法について説明します。

具体的には、これはランキングのリセット時にメールのトリガー、プッシュ通知の送信、インベントリ項目および仮想通貨の付与、CloudScript 関数の実行を行う方法です。

この例では、プライズテーブルのエンドトーナメント賞品を作成し、リセットの実行後にランキングのランクに基づいて 5 人のプレイヤーに仮想通貨を付与する方法について説明します。

要件

Important

これは、高度な チュートリアルです。以下に示すすべての要件が満たされていることを確認してください。要件を満たしていない場合、このチュートリアルを完了 できません。

プレイヤーを作成する方法に関する基本的な知識が必要です。それらのプレイヤーにアクションを実行するにはプレイヤーがランキングに存在している必要があるためです。
また、ゲームマネージャーを初めて使用する場合は、プライズテーブルを作成するために、ゲームマネージャーのクイックスタートに目を通してください。
プライズテーブルを使うには、リセット可能なランキングのしくみに関する一般的な知識が必要です。ランキングについては、チュートリアル「リセットできる統計情報とランキングを使用する」をご覧ください。
さらに、仮想通貨を設定する必要があります。通貨に関するチュートリアルを読み、次のパラメーターを使って 2 つの通貨をセットアップしてください。
- 通貨コード: GO
- 表示名: Gold
- 初期デポジット: 200
- 通貨コード: SI
- 表示名: Silver
- 初期デポジット: 1000

手順 1 - ランキングの作成

[ゲームマネージャー] で以下を実行します。

メニュー左側の [ランキング] に移動します。
[新しいランキング] を選択します。
[統計名] フィールドに tournamentScore_manual というランキングを追加します。
表示されたドロップダウンメニューを使って、[リセット頻度] フィールドを [手動] に設定します。
[集計方法] フィールドに移動し、表示されたドロップダウンメニューから [最大 (常に最大の値を使用)] を選択します。

ゲームマネージャー - ランキング - 新しいランキング

手順 2 - ランキングのプライズテーブルの作成

ランキングが作成されたので、プライズテーブルを関連付けることができます。移動先:

メニュー左側の [ランキング]。
[プライズテーブル] タブを選択します。
[新しいプライズテーブル] ボタンを選択し、[新しいプライズテーブル] ビューに移動します。

ゲームマネージャー - ランキング - プライズテーブル

[新しいプライズテーブル] ビューで、次のようにします。

[情報] 領域に移動し、[新しいプライズテーブル] の [名前] として「エンドトーナメント賞品」と入力します。
[ランキング] ドロップダウンメニューから [tournamentScore_manual] を選択します。

このプライズテーブルでいくつかの操作を実行するには、ランクを設定する必要があります。方法は次のとおりです。

[テーブルコンテンツ] セクションで [+ ランクの追加] を選択します。
[ランク] フォームが表示されます。

ゲームマネージャー - ランキング - 新しいプライズテーブル

[ランク] フォームで次のようにします。

[最上位ランク] フィールドの値が 1 であることを確認します。
[最下位 (この数値を含む)] フィールドの値が 2 であることを確認します。
[種類] ドロップダウンメニューで、[仮想通貨を付与] を選択します。
[仮想通貨コード] ドロップダウンメニューで、量が 10 の [GO (Gold)] を選択します。

ゲームマネージャー - ランキング - プライズテーブル - ランクの追加

次に、2 番目のランク範囲を追加します。

[テーブルコンテンツ] セクションで [+ランクの追加] を選択します (下部にある 2 番目のランクでもかまいません)。
表示された [ランク] フォームで、[ランクフォーム] フィールドの値が 3 であり、[最下位 (この数値を含む)] フィールドの値が 5 であることを確認します。
[仮想通貨コード] ドロップダウンメニューで、量が 10 の [SI (Silver)] を選択します。

ゲームマネージャー - ランキング - プライズテーブル - 2 番目のランクの追加

手順 3 - プレイヤーのランキングの設定

ランキングとそれに関連付けられたプライズテーブルが作成されました。次の手順では、プレイヤーにランキングを設定します。

プレイヤーを作成するには、LoginWithCustomIDを使います。次に、プレイヤーを使って UpdatePlayerStatistics によってランキングを設定します。

UpdatePlayerStatistics を使うには、API 機能を有効にする必要があります。

左側のメニューで、[設定] を選択します。
[API 機能] タブを選択します。
[クライアントにプレイヤー統計情報のポストを許可する] チェックボックスをオンにします。
次に、画面の下部にある [API 機能を保存] ボタンを選択します。

ゲームマネージャー - 設定 - API 機能 - クライアントにプレイヤー統計情報のポストを許可する

C# コードの例

次の C# コード例では、5 人のプレイヤーを作成し、LoginWithCustomID を使ってログインさせます。

その後、UpdatePlayerStatistics を使って、前の手順で作成したランキング (tournamentScore_manual) を、値 105、104、103、102、101 で 5 人のプレイヤーに設定します。

// Note: This is a recursive function. Invoke it initially with no parameter
public void CreatePlayerAndPopulateLeaderboard(int playerIndex = 5) {
    if (playerIndex <= 0) return;
    const string leaderboardName = "tournamentScore_manual";
    PlayFabClientAPI.LoginWithCustomID(new LoginWithCustomIDRequest {
        CustomId = playerIndex.ToString(),
        CreateAccount = true
    }, result => OnLoggedIn(result,playerIndex,leaderboardName), FailureCallback);
}

private void OnLoggedIn(LoginResult loginResult, int playerIndex, string leaderboardName) {
    Debug.Log("Player has successfully logged in with " + loginResult.PlayFabId);
    PlayFabClientAPI.UpdatePlayerStatistics(new UpdatePlayerStatisticsRequest {
        Statistics = new List<StatisticUpdate> {
            new StatisticUpdate {
                StatisticName = leaderboardName,
                Value = playerIndex + 100
            }
        }
    }, result=> OnStatisticsUpdated(result,playerIndex), FailureCallback);
}

private void OnStatisticsUpdated(UpdatePlayerStatisticsResult updateResult, int playerIndex) {
    Debug.Log("Successfully updated player statistic");
    // Recursively invoke for next player
    CreatePlayerAndPopulateLeaderboard(playerIndex - 1);
}

private void FailureCallback(PlayFabError error){
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}

C# コード例の結果の確認

ランキングで 5 人のプレイヤーに正しい値が設定されたことを確認するには、次のようにします。

左側のメニューの [ランキング] を選択します。
[ランキング] タブで [ランキング] リストビューに戻ります。
[tournamentScore_manual] を選択します。値が 105、104、103、102、101 の 5 人のプレイヤーが表示されます。

ゲームマネージャー - ランキング - ランキングの表示 - 値の確認

手順 4 - プレイヤーの初期通貨の確認

確認前に、次のようにします。

手順 2 から左側のメニューの [プレイヤー] に戻ります。
[プレイヤー] タブに移動し、手順 3 で tournamentScore_manualランキング に配置されたプレイヤーを見つけます。
[プレイヤー ID] と、そのプレイヤーの [仮想通貨] タブを選択します。
そのプレイヤーの GO (Gold) および SI (Silver) 通貨の値を記録します。

確認する前に、手順 2 からテスト プレイヤーに戻ります。

[プレイヤー] に移動し、手順 3 で tournamentScore_manual ランキングに配置されたプレイヤーを見つけます。
[プレイヤー ID] と、そのプレイヤーの [仮想通貨] タブを選択します。
そのプレイヤーの GO (Gold) および SI (Silver) 通貨の値を記録します。
手順 3 で tournamentScore_manual ランキング に配置された 5 人のプレイヤーのうち残り 4 人に対してこれを行います。
それらのプレイヤーの GO (Gold) および SI (Silver) 通貨の値を記録してください (リセット後にプライズテーブルが機能したことを確認するため、後で重要になります)。