​

快速入門：將第一個物品新增至玩家的庫存

​

必要條件

• 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 (需要遊戲實體權杖)，或在 Game Manager 中瀏覽至 [Title] > Players > [Player] > Inventory (V2)，將虛擬貨幣授與玩家。
• 無法以指定的價格購買該物品。
  • 如果您呼叫 PurchaseInventoryItems 並收到 1071 錯誤碼，表示 PriceAmounts 欄位與目錄中指定的價格不符。

​

後續步驟