> ## 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 提供了一个灵活而强大的平台来创建和管理虚拟商品。你可以定义不同类型的物品——例如耐久品、消耗品、捆绑包、订阅和虚拟货币——并跟踪玩家库存中物品的所有权和使用情况。

## 关键概念

* **目录 (Catalog)** - 目录是游戏中所有可用物品的集合。目录提供了一种简便的方式来管理游戏的虚拟物品。有关更多信息，请参见 [目录概览](/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview)。
* **目录物品 (Catalog Items)** – 在你的目录中定义的单个物品。它们可以代表任何类型的虚拟商品，例如武器、服装、增强道具、战利品箱等。你可以自定义属性和行为以适应你的游戏设计。
* **目录商店 (Catalog Stores)** - 商店允许你为不同目的创建多个物品列表，例如季节性事件、促销或测试。请参见 [商店](/services/playfab/economy-monetization/economy-v2/catalog/stores)。
* **捆绑包 (Bundles)** - 捆绑包是包含对其他物品引用的目录物品。当玩家购买捆绑包时，引用的物品会被拆包并添加到他们的库存中。
* **订阅 (Subscriptions)** - 订阅授予对耐久物品的基于时间的访问权限。订阅内的物品在订阅期间可在玩家的库存中使用。请参见 [订阅](/services/playfab/economy-monetization/economy-v2/catalog/subscriptions)。
* **玩家库存集合 (Player Inventory Collections)** - 库存是玩家在游戏中所拥有物品的记录。它包含有关物品数量、虚拟货币余额和自定义属性的信息。所有玩家账户可以有一个或多个称为 [集合](/services/playfab/economy-monetization/economy-v2/inventory/collections) 的库存。
* **堆栈 (Stacks)** - 堆栈允许同一物品的多个不同实例存在于单个库存中，每个都有自己的数量和自定义属性。请参见 [堆栈](/services/playfab/economy-monetization/economy-v2/inventory/stacks)。
* **虚拟货币 (Virtual Currency)** - 虚拟货币是游戏中用作交换媒介的一种物品。你可以使用虚拟货币从目录或商店购买物品、从应用内购实施软货币，或驱动游戏机制。

## 关键 API

有一组丰富的 API 可用于与游戏中的物品和库存进行交互。你可以使用这些 API 执行诸如购买物品、授予物品、更新库存、在玩家之间转移物品以及查询交易历史等操作。

### 库存管理

* **[GetInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-inventory-items)** - 检索实体的当前库存。支持通过 `ContinuationToken` 进行分页，并通过 [TurboLoading](/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)** - 设置物品数量或修改库存物品上的 [显示属性](/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)** - 从玩家库存中检索交易事件。支持按时间戳过滤和分页，用于查看完整操作历史。请参见 [交易历史](/services/playfab/economy-monetization/economy-v2/inventory/transaction-history)。

### 可靠性

* **幂等性 (Idempotency)** - 所有库存 API 都支持 `IdempotencyId` 参数，可以在没有重复副作用的情况下安全地重试请求。ID 强制执行 14 天。请参见 [幂等性](/services/playfab/economy-monetization/economy-v2/inventory#idempotency)。

有关每个操作的完整 API 参考和详细示例，请参见 [库存 API 文档](/services/playfab/economy-monetization/economy-v2/inventory) 和 [PlayFab REST API 参考](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory)。


## Related topics

- [Economy（旧版）快速入门](/zh-CN/services/playfab/economy-monetization/economy/quickstart.md)
- [市场兑换 - 概览](/zh-CN/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/overview.md)
- [物品（旧版 Economy）](/zh-CN/services/playfab/economy-monetization/economy/items/index.md)
- [Economy v2 概览](/zh-CN/services/playfab/economy-monetization/economy-v2/overview.md)
- [库存 ETag](/zh-CN/services/playfab/economy-monetization/economy-v2/inventory/etags.md)