> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 玩家庫存快速入門

> 使用 PlayFab Beta SDK 驗證玩家、搜尋目錄、購買物品，並確認物品出現在玩家的 Economy v2 庫存中。

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

<Info>
  Economy v2 現已正式推出。如需支援與意見反應，請前往 [PlayFab 論壇](https://community.playfab.com)。
</Info>

使用 PlayFab Beta SDK 購買物品，並確認物品已新增至玩家的庫存，藉此熟悉玩家庫存。取得實體權杖以透過 API 與您的遊戲互動之後，您將在目錄中搜尋物品、購買該物品，然後取得玩家的庫存以找到所購買的物品。

## 必要條件

* [PlayFab 開發人員帳戶](https://developer.playfab.com)
* PlayFab Beta SDK (您可以在 [Postman 快速入門](/zh-TW/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections)中找到更多資訊)
* 目錄中至少有一個物品 (您可以在 [Economy v2 快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart)中找到更多資訊)
* 至少有一位玩家擁有足夠的虛擬貨幣可購買物品

## 以玩家身分登入

您必須先讓玩家登入，以取得本快速入門其餘 API 呼叫所需的安全性權杖。您可以在[玩家驗證](/zh-TW/services/playfab/identity/player-identity/login)頁面上找到更多資訊。

## 搜尋物品

若要在目錄中尋找物品，請呼叫 `Search`。在呼叫本文中：

```json theme={null}
{
  "Search": "[Item Title]",
  "Top": 1
}
```

* `Search` 是搜尋字串，會針對目錄中每個物品的 Title、Description 和 Keywords 進行模糊搜尋
* `Top` 是整數，用於決定要傳回多少筆結果，在此案例中我們只需要一筆

<Note>
  您可以在[搜尋快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/search)中了解更多欄位。
</Note>

在回應中，擷取下列欄位：

* `Items` > `Id` - 物品的目錄 ID
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId` - 用於購買物品的虛擬貨幣 ID
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount` - 購買物品所需的虛擬貨幣數量

<Note>
  只有遊戲實體 (Title Entities) 能夠設定物品的價格。
</Note>

## 購買物品

若要購買物品，請呼叫 `PurchaseInventoryItems`。在呼叫本文中：

```json theme={null}
{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
```

* `Item.Id` 是物品的 ID (取自上一個步驟的 `Search` 回應)
* `Amount` 是玩家要購買的物品數量
* `ItemId` 是用於購買物品的虛擬貨幣 ID (取自上一個步驟的 `Search` 回應)
* `Amount` 是購買物品所需的虛擬貨幣數量 (取自上一個步驟的 `Search` 回應)

## 取得玩家的庫存物品

透過 `GetInventoryItems` 查看玩家新購買的物品。在呼叫中，請確定本文為空白。您可以在本文中指定實體，但並非必要，因為該資訊已透過標頭中的實體權杖傳入。

回應中包含玩家擁有的每個物品 ID 以及每個物品的數量。新購買的物品會出現在玩家的庫存中。

<Note>
  如果玩家的庫存中已有具有相同 `StackId` 的該物品，購買後您不會看到另一個物品執行個體，而是會看到 `Amount` 欄位增加。
</Note>

## 疑難排解

* 資金不足
  * 如果您呼叫 `PurchaseInventoryItems` 並收到 `422: InsufficientFunds` 錯誤，表示玩家沒有足夠的虛擬貨幣可購買該物品。您可以呼叫 `AddInventoryItems` (需要遊戲實體權杖)，或在 Game Manager 中瀏覽至 **\[Title]** > **Players** > **\[Player]** > **`Inventory (V2)`**，將虛擬貨幣授與玩家。
* 無法以指定的價格購買該物品。
  * 如果您呼叫 `PurchaseInventoryItems` 並收到 `1071` 錯誤碼，表示 `PriceAmounts` 欄位與目錄中指定的價格不符。

## 後續步驟

既然您已購買玩家的第一個物品，接下來可以消耗該物品、將該物品新增至商店以進行銷售，以及建立並購買包含該物品的組合包。

<Note>
  \[!div class="nextstepaction"] [玩家庫存教學課程](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
</Note>

<Note>
  \[!div class="nextstepaction"] [商店](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/stores)
</Note>

<Note>
  \[!div class="nextstepaction"] [組合包](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/bundles)
</Note>


## Related topics

- [玩家資料快速入門](/zh-TW/services/playfab/player-progression/player-data/quickstart.md)
- [玩家自訂屬性快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [Economy (舊版) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/quickstart.md)
- [快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [物品 (舊版 Economy) 快速入門](/zh-TW/services/playfab/economy-monetization/economy/items/quickstart.md)