集合

Economy v2 現已正式推出。如需支援與意見反應，請前往 PlayFab 論壇。

Economy v2 庫存服務引進了集合的概念，可為您的庫存需求提供更大的彈性與支援。集合是讓單一玩家/PlayerId 擁有多個庫存的機制。此功能可用來為同一位玩家的不同角色管理多個庫存、為不同平台提供個別的庫存等，還有更多用途！庫存 API 呼叫可以接受 CollectionId 參數，以指定要在其中執行動作的集合/庫存。將項目/堆疊新增至未使用的 CollectionId，即可建立新的集合。

管理庫存集合

GetInventoryCollectionIds

使用 GetInventoryCollectionIds API，您可以取得指定玩家的 CollectionId 清單。玩家只能存取自己的 ID 清單。遊戲實體可以傳入 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