> ## 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 Economy v2 的目錄與庫存概念，包括物品類型、組合包、商店、虛擬貨幣，以及玩家擁有權追蹤。

# PlayFab 物品與庫存概觀

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

物品與庫存是打造引人入勝且沉浸式遊戲的重要功能。它們讓您能為玩家提供自訂選項、獎勵、進度系統及營利機會。

PlayFab Economy v2 提供彈性且強大的平台，用於建立和管理虛擬商品。您可以定義不同類型的物品 (例如耐久性商品、消耗性商品、組合包、訂閱和虛擬貨幣)，並追蹤物品在玩家庫存中的擁有權與使用情況。

## 主要概念

* **目錄** - 目錄是遊戲中所有可用物品的集合。目錄提供管理遊戲虛擬物品的簡便方式。如需詳細資訊，請參閱[目錄概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview)。
* **目錄物品** – 在目錄中定義的個別物品。它們可以代表任何類型的虛擬商品，例如武器、服裝、強化道具、戰利品箱等。您可以自訂屬性與行為，以符合您的遊戲設計。
* **目錄商店** - 商店可讓您針對不同用途建立多個物品清單，例如季節性活動、促銷或測試。請參閱[商店](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/stores)。
* **組合包** - 組合包是包含其他物品參考的目錄物品。玩家購買組合包時，所參考的物品會被拆開並新增至其庫存。
* **訂閱** - 訂閱會授與耐久性商品的限時存取權。訂閱中的物品在訂閱期間內會出現在玩家的庫存中。請參閱[訂閱](/zh-TW/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)。
* **玩家庫存集合** - 庫存是玩家在遊戲中所擁有物品的記錄。其中包含物品數量、虛擬貨幣餘額及自訂屬性的資訊。所有玩家帳戶都可以擁有一或多個庫存，稱為[集合](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/collections)。
* **堆疊** - 堆疊可讓同一物品的多個不同執行個體存在於單一庫存中，每個執行個體都有自己的數量和自訂屬性。請參閱[堆疊](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/stacks)。
* **虛擬貨幣** - 虛擬貨幣是一種在遊戲中作為交易媒介的物品。您可以使用虛擬貨幣從目錄或商店購買物品、透過應用程式內購買實作軟性貨幣，或驅動遊戲機制。

## 主要 API

我們提供豐富的 API，可用於與遊戲中的物品和庫存互動。您可以使用這些 API 執行購買物品、授與物品、更新庫存、在玩家之間轉移物品，以及查詢交易記錄等動作。

### 庫存管理

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)** - 擷取實體目前的庫存。支援使用 `ContinuationToken` 分頁，以及透過 [TurboLoading](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/turboloading) 大量載入。
* **[AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items)** - 將物品直接新增至玩家的庫存。
* **[SubtractInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/subtract-inventory-items)** - 減少玩家庫存中的物品數量。
* **[UpdateInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/update-inventory-items)** - 設定物品數量，或修改庫存物品的[顯示屬性](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory#display-properties)。
* **[DeleteInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/delete-inventory-items)** - 從玩家的庫存中移除整個物品堆疊。

### 購買與交易

* **[PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items)** - 使用虛擬貨幣購買目錄物品或組合包。從玩家的庫存中扣除貨幣，並授與所購買的物品。
* **[TransferInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/transfer-inventory-items)** - 在玩家之間、玩家的庫存集合之間，或同一庫存內的堆疊之間轉移物品。

### 批次作業

* **[ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations)** - 在單一不可部分完成的要求中，批次處理最多 10 個庫存作業 (Add、Subtract、Update、Purchase、Transfer、Delete)。若有任何作業失敗，整個批次都會復原。

### 記錄與診斷

* **[GetTransactionHistory](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-transaction-history)** - 從玩家的庫存擷取交易事件。支援依時間戳記篩選及分頁，以檢閱完整的作業記錄。請參閱[交易記錄](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/transaction-history)。

### 可靠性

* **等冪性** - 所有庫存 API 都支援 `IdempotencyId` 參數，可安全地重試要求，而不會產生重複的副作用。ID 會強制執行 14 天。請參閱[等冪性](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory#idempotency)。

如需完整的 API 參考與每個作業的詳細範例，請參閱[庫存 API 文件](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory)和 [PlayFab REST API 參考](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory)。


## Related topics

- [庫存 ETag](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/etags.md)
- [PlayFab 庫存 API](/zh-TW/services/playfab/economy-monetization/economy-v2/inventory/index.md)
- [Winter Starfall PlayFab 示範遊戲概觀](/zh-TW/services/playfab/demo-game/overview.md)
- [Economy v2 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/overview.md)
- [Economy v2 中的 ETag 與並行控制](/zh-TW/services/playfab/economy-monetization/economy-v2/tutorials/etags-and-concurrency-control.md)