集合

Economy v2 现已正式发布。如需支持和反馈，请访问 PlayFab 论坛。

Economy v2 库存服务引入了集合的概念，可以为你的库存需求增加更大的灵活性和支持。集合是允许单个玩家/PlayerId 拥有多个库存的机制。此功能可用于管理同一玩家的不同角色的多个库存、为不同平台设置单独的库存等！库存 API 调用可以接受 CollectionId 参数，该参数指定要执行操作的集合/库存。通过将物品/堆栈添加到未使用的 CollectionId，可创建新集合。

管理库存集合

GetInventoryCollectionIds

使用 GetInventoryCollectionIds API，你可以获取给定玩家的 CollectionId 列表。玩家仅限于访问自己的 ID 列表。Title Entities 可以传入 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