1.1　ドロップテーブルとは

　ドロップテーブルとは、アイテムごとに確率をもたせてひとつのテーブルとして管理することで、その確率に応じてランダムにアイテムを取得できる機能のことです。ひとつの使い方の例としては、ガチャの機能を実現できます。たとえば、プレイヤーがゲーム内通貨を消費することでガチャを引き、確率に応じてモンスターを手に入れることができるという機能ですね（図1.1）。また、クエストのクリア報酬として付与するアイテムも、8割は通常アイテムをドロップして、2割はレアアイテムをドロップする、という使い方も可能です。

1.2　ドロップテーブル用のアイテムを登録する

　ドロップテーブルを使用するには、まずアイテムが必要になります。私は、図1.2の内容で登録しました。ここは、何でも好きなアイテムで構いません。

1.3　ドロップテーブルを登録する

　アイテムが登録できたら、ドロップテーブルを登録します。「エコノミー > カタログ > ドロップテーブル」と進み、「新しいドロップテーブル」を選択してください（図1.3）。

　テーブルIDを入力した後、「ドロップテーブルを追加」を選択しましょう（図1.4）。図1.5が表示されるので、そこから先ほど登録したアイテムを選択すると、図1.6の状態になります。

　加重というのは、そのアイテムが全体のどれだけの比率でドロップするかを表す数値のことです。加重が大きければ大きいほど、ドロップ率が上がります。隣に表示されている「オッズ」というのが、ドロップ率のことです。好きな加重を入力した後は、「ドロップテーブルを保存」を選択してください。これで、ドロップテーブルの保存が完了しました。

1.4　アイテムをドロップする

サーバー処理の実装

　「アイテムをひとつドロップする」というケースを見てみましょう。ドロップテーブルに従ってアイテムをひとつドロップするには、EvaluateRandomResultTable¹を使用します。TableIdとCatalogVersionが必要になるので、クライアント側から引数で渡してあげましょう。結果は、ResultItemIdというプロパティで取得できます。アイテムのドロップができたので、GrantItemsToUser²を使用して、プレイヤーにアイテムを付与します。最後に、付与結果をクライアント側に返して、ひと通りの処理が完了です。

リスト1.1: アイテムをドロップするサーバー処理

[FunctionName("DropItem")]
public static async Task<dynamic> DropItem(
[HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
ILogger log)
{
    string body = await req.ReadAsStringAsync();
    log.LogInformation($"Body : {body}");
    var context = JsonConvert
                  .DeserializeObject<FunctionExecutionContext<dynamic>>(body);
    var args = context.FunctionArgument;
    string playFabId = context.CallerEntityProfile.Lineage.MasterPlayerAccountId;
    var serverApi = GetServerInstance(context.TitleAuthenticationContext);

    var evaluateResult = await serverApi.EvaluateRandomResultTableAsync(new EvaluateRandomResultTableRequest
    {
        TableId = args["TableId"],
        CatalogVersion = args["CatalogVersion"]
    });

    var grantResult = await serverApi.GrantItemsToUserAsync(new GrantItemsToUserRequest
    {
        PlayFabId = playFabId,
        CatalogVersion = args["CatalogVersion"],
        ItemIds = new List<string> { evaluateResult.Result.ResultItemId }
    });

    return new
    {
        error = PlayFabSimpleJson.SerializeObject(grantResult.Error),
        result = PlayFabSimpleJson
                 .SerializeObject(grantResult.Result.ItemGrantResults)
    };
}

クライアント側の実装

　クライアントから呼び出すときは、TableIdとCatalogVersionを引数で渡します。サーバー側の返り値としてはList<GrantedItemInstance>を指定しているのですが、クライアント側では指定することができません。そこで、List<ItemInstance>を代わりに指定しています。問題なく実行できると、リスト1.4の結果が返ってきます。今回は、みどりの魔物がドロップされたことが確認できました。

リスト1.2: アイテムをドロップする処理の呼び出し

private void DropItem()
{
    CallAzureFunctions<List<ItemInstance>>(
        "DropItem",
            new
            {
                CatalogVersion = "Main",
                TableId = "dt_normal"
            },
        funcResult =>
        {
            Debug.Log("アイテムドロップ成功！");
            Debug.Log(PlayFabSimpleJson.SerializeObject(funcResult));
        }, funcError =>
        {
            Debug.Log("実行時にエラーが発生しました。");
            Debug.Log(funcError.GenerateErrorReport());
        });
}

リスト1.3: Azure Functionsを呼び出す共通関数

/// <summary>
/// Azure Functions の呼び出し
/// </summary>
/// <typeparam name="T">取得結果の型</typeparam>
/// <param name="funcName">呼び出す関数名</param>
/// <param name="funcParam">サーバーに渡すパラメータ</param>
/// <param name="onSuccess">成功時コールバック</param>
/// <param name="onError">失敗時コールバック</param>
public void CallAzureFunctions<T>(
    string funcName,
    object funcParam,
    Action<T> onSuccess = null,
    Action<PlayFabError> onError = null)
{

    PlayFabCloudScriptAPI.ExecuteFunction(new
        PlayFab.CloudScriptModels.ExecuteFunctionRequest()
    {
        Entity = new PlayFab.CloudScriptModels.EntityKey()
        {
            Id = PlayFabSettings.staticPlayer.EntityId,
            Type = PlayFabSettings.staticPlayer.EntityType
        },
        FunctionName = funcName,
        FunctionParameter = funcParam,
        GeneratePlayStreamEvent = true,
    }, result =>
    {
        Debug.Log("Azure Functions 実行成功！");

        // 返り値の取り出し
        var jsonResult = (JsonObject)result.FunctionResult;
        var funcSuccess = PlayFabSimpleJson.DeserializeObject<T>
                                            (jsonResult["result"].ToString());
        var funcError = PlayFabSimpleJson.DeserializeObject<PlayFabError>
                                          (jsonResult["error"].ToString());

        if (result.FunctionResultTooLarge != null
            && (bool)result.FunctionResultTooLarge)
        {
            onError?.Invoke(funcError);
            return;
        }

        if (funcError == null)
            onSuccess?.Invoke(funcSuccess);
        else
            onError?.Invoke(funcError);
    }, error =>
    {
        onError.Invoke(error);
    });
}

リスト1.4: 実行結果

[
    {
        "Annotation": null,
        "BundleContents": null,
        "BundleParent": null,
        "CatalogVersion": "Main",
        "CustomData": null,
        "DisplayName": "みどりの魔物",
        "Expiration": null,
        "ItemClass": "Monster",
        "ItemId": "monster_green",
        "ItemInstanceId": "A4D0364CEB3E28F9",
        "PurchaseDate": "2020-09-14T12:51:36.219Z",
        "RemainingUses": 3,
        "UnitCurrency": null,
        "UnitPrice": 0,
        "UsesIncrementedBy": 1
    }
]