コレクション

Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラムを参照してください。

Economy v2 の Inventory サービスは、インベントリのニーズに対してより高い柔軟性とサポートを追加できるコレクションの概念を導入します。コレクションは、単一のプレイヤー/PlayerId が複数のインベントリを持てるようにする仕組みです。この機能は、同じプレイヤーの異なるキャラクター向けに複数のインベントリを管理する場合や、異なるプラットフォーム向けに個別のインベントリを持つ場合など、さまざまな用途に使用できます。 Inventory API 呼び出しは、アクションを実行するコレクション/インベントリを指定する CollectionId パラメーターを受け取ることができます。新しいコレクションの作成は、未使用の CollectionId にアイテム/スタックを追加することで行われます。

インベントリコレクションの管理

GetInventoryCollectionIds

GetInventoryCollectionIds API を使用して、特定のプレイヤーの CollectionId のリストを取得できます。プレイヤーは自分自身の ID リストにのみアクセスできます。Title Entity では Entity パラメーターを渡して、アクセスしたいプレイヤーのインベントリを指定できます。 GetInventoryCollectionIds リクエストの例:

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "ABCD12345678"
  },
  "Count": 15,
  "ContinuationToken": "abc="
}

このリクエストは、次のレスポンスを返します。

{
  "data": {
  "CollectionIds": [
    "default",
    "main_character"
    ]
  }
}

継続トークン

検索レスポンスから返される ContinuationToken フィールドは、複数の結果件数をページングするためにインベントリリクエストに渡すことができます。

新しいインベントリコレクションの追加

プレイヤーの新しいコレクションを作成するには、新しい CollectionId を指定して任意の書き込みリクエストを実行します。たとえば、次の AddInventoryItems リクエストは collectionId main_character を使用しています。

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "ABCD12345678"
    },
    "CollectionId": "main_character",
    "Item": {
        "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
    },
    "Amount": 10,
}

上記のリクエストは、まったく新しいインベントリコレクションを作成してアイテムを 10 個追加するか、既存の main_character インベントリコレクションが既に存在する場合はそこに 10 個追加します。

DeleteInventoryCollection

DeleteInventoryCollectionId API では、削除する CollectionId を定義できます。削除は非同期操作であり、大きなコレクションでは時間がかかる場合があります。削除操作が完了するまで、コレクションを再作成することはできません。 DeleteInventoryCollectionIds リクエストの例:

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "ABCD12345678"
  },
  "CollectionId": "main_character"
}

現在、インベントリコレクションを削除する唯一の方法は API です。Game Manager では、現在のところ、新規および既存のコレクションを表示したり、アイテムを追加したりすることしかできません。将来的に追加機能が加わる予定です。

ExecuteInventoryOperations API

ExecuteInventoryOperations API で CollectionId パラメーターを設定できます。このパラメーターを使用すると、操作を実行するコレクションを定義できます。スタックを使用した ExecuteInventoryOperations リクエストの例:

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "ABCD12345678"
    },
    "CollectionId": "main_character",
    "Operations": [
        {
            "Update": {
                "Item" {
                    "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
                    "Amount": 10
                }
            }
        },
        {
            "Subtract": {
                "Item" {
                    "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
                },
                "Amount": 5
            }
        }
    ]
}

​コレクション

​インベントリ コレクションの管理

​GetInventoryCollectionIds

​継続トークン

​新しいインベントリ コレクションの追加

​DeleteInventoryCollection

​ExecuteInventoryOperations API

コレクション

インベントリコレクションの管理

GetInventoryCollectionIds

継続トークン

新しいインベントリコレクションの追加

DeleteInventoryCollection

ExecuteInventoryOperations API