PlayFab 物品和库存概览
Economy v2 现已正式发布。如需支持和反馈，请访问 PlayFab 论坛。
关键概念
- 目录 (Catalog) - 目录是游戏中所有可用物品的集合。目录提供了一种简便的方式来管理游戏的虚拟物品。有关更多信息，请参见 目录概览。
- 目录物品 (Catalog Items) – 在你的目录中定义的单个物品。它们可以代表任何类型的虚拟商品，例如武器、服装、增强道具、战利品箱等。你可以自定义属性和行为以适应你的游戏设计。
- 目录商店 (Catalog Stores) - 商店允许你为不同目的创建多个物品列表，例如季节性事件、促销或测试。请参见 商店。
- 捆绑包 (Bundles) - 捆绑包是包含对其他物品引用的目录物品。当玩家购买捆绑包时，引用的物品会被拆包并添加到他们的库存中。
- 订阅 (Subscriptions) - 订阅授予对耐久物品的基于时间的访问权限。订阅内的物品在订阅期间可在玩家的库存中使用。请参见 订阅。
- 玩家库存集合 (Player Inventory Collections) - 库存是玩家在游戏中所拥有物品的记录。它包含有关物品数量、虚拟货币余额和自定义属性的信息。所有玩家账户可以有一个或多个称为 集合 的库存。
- 堆栈 (Stacks) - 堆栈允许同一物品的多个不同实例存在于单个库存中，每个都有自己的数量和自定义属性。请参见 堆栈。
- 虚拟货币 (Virtual Currency) - 虚拟货币是游戏中用作交换媒介的一种物品。你可以使用虚拟货币从目录或商店购买物品、从应用内购实施软货币，或驱动游戏机制。
关键 API
有一组丰富的 API 可用于与游戏中的物品和库存进行交互。你可以使用这些 API 执行诸如购买物品、授予物品、更新库存、在玩家之间转移物品以及查询交易历史等操作。库存管理
- GetInventoryItems - 检索实体的当前库存。支持通过
ContinuationToken进行分页，并通过 TurboLoading 进行批量加载。 - AddInventoryItems - 直接向玩家的库存添加物品。
- SubtractInventoryItems - 减少玩家库存中的物品数量。
- UpdateInventoryItems - 设置物品数量或修改库存物品上的 显示属性。
- DeleteInventoryItems - 从玩家库存中删除整个物品堆栈。
购买和交易
- PurchaseInventoryItems - 使用虚拟货币购买目录物品或捆绑包。从玩家库存中扣除货币并授予所购物品。
- TransferInventoryItems - 在玩家之间、玩家的库存集合之间或同一库存内的堆栈之间转移物品。
批处理操作
- ExecuteInventoryOperations - 在单个原子请求中批量最多 10 个库存操作（Add、Subtract、Update、Purchase、Transfer、Delete）。如果任何操作失败，整个批处理都会回滚。
历史记录和诊断
- GetTransactionHistory - 从玩家库存中检索交易事件。支持按时间戳过滤和分页，用于查看完整操作历史。请参见 交易历史。
可靠性
- 幂等性 (Idempotency) - 所有库存 API 都支持
IdempotencyId参数，可以在没有重复副作用的情况下安全地重试请求。ID 强制执行 14 天。请参见 幂等性。