​

快速入门：向玩家库存添加你的第一个物品

​

先决条件

• 一个 PlayFab 开发者账户
• PlayFab Beta SDK（你可以在 Postman 快速入门 上找到更多信息）
• 目录中至少有一个物品（你可以在 Economy v2 快速入门 上找到更多信息）
• 至少一个具有足够虚拟货币来购买物品的玩家

​

以玩家身份登录

​

搜索物品

{
  "Search": "[Item Title]",
  "Top": 1
}

• Search 是搜索字符串，与目录中每个物品的 Title、Description 和 Keywords 进行模糊搜索
• Top 是一个整数，用于确定要返回多少个结果——在本例中，我们只需要一个

• Items > Id - 物品的目录 ID
• Items > PriceOptions > Prices > Amounts > ItemId - 用于购买该物品的虚拟货币的 ID
• Items > PriceOptions > Prices > Amounts > Amount - 购买该物品所需的虚拟货币数量

​

购买物品

{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}

• Item.Id 是物品的 ID（从上一步的 Search 响应中提取）
• Amount 是玩家购买的物品数量
• ItemId 是用于购买该物品的虚拟货币的 ID（从上一步的 Search 响应中提取）
• Amount 是购买该物品所需的虚拟货币数量（从上一步的 Search 响应中提取）

​

获取玩家的库存物品

​

疑难解答

• 资金不足
  • 如果你调用 PurchaseInventoryItems 并收到 422: InsufficientFunds 错误，则玩家没有足够的虚拟货币来购买物品。你可以通过调用 AddInventoryItems（需要 title entity token）或在 Game Manager 中导航到 [Title] > Players > [Player] > Inventory (V2) 来向玩家授予虚拟货币。
• 无法以指定价格购买该物品。
  • 如果你调用 PurchaseInventoryItems 并收到 1071 错误代码，则 PriceAmounts 字段与目录中指定的价格不匹配。

​

后续步骤