> ## 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.

# Economy v2 概览

> 了解 PlayFab Economy v2 架构，包括幂等交易、批处理操作、大型目录以及对高规模游戏的库存支持。

<Info>
  Economy v2 现已正式发布。如需支持和反馈，请访问 [PlayFab 论坛](https://community.playfab.com)。
</Info>

Economy v2 是对现有 PlayFab 货币化功能套件的重大改变。此变化的目标是支持拥有数亿活跃玩家、大型进程系统和巨型库存的游戏。该架构在现代 Azure Stack 上从头开始重建。它针对与以下功能相关的开发者需求。

* 幂等交易
* 批处理操作
* 处理高[并发](/services/playfab/economy-monetization/economy-v2/catalog/etags)率，尤其是库存交互
* 大型统一目录（每个实体最多 20 GB）的游戏内商品或用户生成内容 (UGC)，支持多个实体
* 单个目录物品文档，而不是将所有物品存储在单个文档中
* 大型玩家库存（[数千个物品](/services/playfab/economy-monetization/economy-v2/limits)）
* 与 PlayFab 实体的集成

Economy v2 的设计具有你从其他 PlayFab 服务所期望的相同灵活性和可扩展性。虽然该架构对 PlayFab 来说是新的，但它经过实战检验并支持内部 Microsoft 游戏，例如 **Minecraft**、**Sea of Thieves** 和 **Flight Simulator**。

想要了解我们制作 Economy v2 的原因以及如何在游戏中使用这些改进？

<iframe src="https://www.youtube.com/embed/NcvFFgTZ6ek" width="100%" height="400" allowFullScreen frameBorder="0" />

## 我应该使用哪个版本的 Economy？

使用版本 2。如果你使用的是版本 1，请考虑升级。虽然 Microsoft 没有弃用 v1，并将为所有游戏维护和支持它，但它处于仅修复错误模式。新的 Economy 功能仅为版本 2 开发。有关两个版本之间差异的更多信息，请参见 [常见问题解答](/services/playfab/economy-monetization/economy-v2/faq)。

## Economy v2 中的新功能

Economy v2 引入了 v1 中没有的几项新功能：

* [库存](/services/playfab/economy-monetization/economy-v2/inventory) 和目录之间的更新交互允许你支持独特物品、非独特物品、物品堆栈和多个物品堆栈。
* 你可以上传和管理[元数据](/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties)以及内容（包括图片和文件），与目录物品一起。
* 你可以使用经济设置创建到游戏内容的[深度链接](/services/playfab/economy-monetization/economy-v2/catalog/deep-links)。
* 可自定义的[目录搜索](/services/playfab/economy-monetization/economy-v2/catalog/search)使你能够使用标签和内容类型设置自定义视图。
* [本地化](/services/playfab/economy-monetization/economy-v2/catalog/localization)物品描述和标题的简单方法。
* 支持 PlayerEntity 面向的[物品评分和评论](/services/playfab/economy-monetization/economy-v2/catalog/ratings) 的 API。
* 支持[使用草稿状态创作](/services/playfab/economy-monetization/economy-v2/catalog/item-status) 和 [目录管理员和审阅者的策略权限集](/services/playfab/economy-monetization/economy-v2/settings) 中的自定义工作流。你可以使用未来的开始日期预发布目录物品。
* 你可以链接到多个外部市场物品的[捆绑包物品](/services/playfab/economy-monetization/economy-v2/catalog/bundles)。
* [库存集合](/services/playfab/economy-monetization/economy-v2/inventory/collections)允许单个玩家拥有多个库存，例如每角色或每平台。
* [库存堆栈](/services/playfab/economy-monetization/economy-v2/inventory/stacks) 使同一物品的多个不同实例可以在一个库存中，每个都有自己的数量和属性。
* [TurboLoading](/services/playfab/economy-monetization/economy-v2/inventory/turboloading) 通过一次压缩的 API 调用加载整个库存（最多 10,000 个物品），以实现更快的启动。
* [用户生成内容 (UGC)](/services/playfab/economy-monetization/economy-v2/ugc/overview)，使玩家能够使用内置的审核管道创建、上传和搜索经过审核的内容。
* [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations) 在单个请求中原子性地批处理库存操作。如果任何操作失败，整个批处理都会回滚。
* [ETags](/services/playfab/economy-monetization/economy-v2/catalog/etags) 为目录和库存更新提供乐观并发控制，防止竞争条件。
* 内置的[欺诈防范和收据验证](/services/playfab/economy-monetization/economy-v2/fraud-prevention)，跨 Apple、Google、Steam、Nintendo、PlayStation Store 和 Microsoft Store 市场。
* [针对性优惠](/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers)，通过为不同的玩家群体量身定制动态定价实现细分独家商店。

## 与 v1 的变化

Economy 中限制过多以至于无用的功能没有进入 v2。为了弥补这一限制，产品团队推出了 Azure Functions 作为 CloudScript 的增强后继者。团队还提供了配方式文档，作为你自己的自定义实现的起点。产品团队随后专注于你告诉他们最重要的内容。

以下 v1 功能未作为 Economy v2 中的原生物品类型包含在内。某些功能可以使用 v2 构建块部分复制，而其他功能则需要通过 [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview) 进行自定义逻辑。

### 部分支持

你可以使用现有的 v2 API 和构建块实现这些 v1 功能：

* **物品转换**：你可以使用 [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations) API 实现物品转换（制作），它在单个请求中原子性地减去输入物品并添加结果。有关示例，请参见 [制作游戏教程](/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context)。
* **容器（固定内容）**：你可以使用[捆绑包和虚拟货币](/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents) 实现始终授予相同物品的容器。一个货币令牌代表容器，购买定价为一个令牌的捆绑包会授予其内容。

### 不支持

这些 v1 功能没有原生的 v2 等效项，需要自定义逻辑（例如使用 Azure Functions）：

* **交易**：V1 提供玩家之间的原子双向物品交换。V2 没有原生的交易 API。实现玩家对玩家的交易需要通过 [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview) 进行自定义编排。
* **限量物品**：V1 支持具有有限全球供应的目录物品。V2 需要服务器端逻辑来跟踪和强制执行全球数量上限。
* **掉落表**：V1 有内置的加权随机战利品表。V2 需要使用 Azure Functions 进行自定义随机选择逻辑。有关完整实现，请参见[掉落表和随机战利品教程](/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot)。
* **容器（随机）**：与掉落表配对的 V1 容器在打开时授予随机物品。V2 需要自定义逻辑来减去容器并授予随机选择的物品。请参见[掉落表和随机战利品教程](/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot)。
* **充能率**：V1 允许具有随时间再生的使用次数的物品。V2 需要自定义基于时间的逻辑来计算和授予再生的数量。
* **段的商店支持**：V1 允许玩家段和商店之间的自动链接。V2 同时具有 [商店](/services/playfab/economy-monetization/economy-v2/catalog/stores) 和 [段](/services/playfab/player-progression/player-data/player-segments)，并支持带有段独家商店的[针对性优惠](/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers)，但你必须手动设置配置，而不是使用自动分配。

## 另请参阅

* [快速入门](/services/playfab/economy-monetization/economy-v2/quickstart)
* [设置](/services/playfab/economy-monetization/economy-v2/settings)
* [商店](/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [库存](/services/playfab/economy-monetization/economy-v2/inventory)
* [市场集成](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [欺诈防范](/services/playfab/economy-monetization/economy-v2/fraud-prevention)
* [TurboLoading](/services/playfab/economy-monetization/economy-v2/inventory/turboloading)
* [限制](/services/playfab/economy-monetization/economy-v2/limits)
* [常见问题解答](/services/playfab/economy-monetization/economy-v2/faq)


## Related topics

- [Economy v2 设置概览](/zh-CN/services/playfab/economy-monetization/economy-v2/settings.md)
- [目录概览](/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [Economy V2 段操作](/zh-CN/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/segment-actions.md)
- [Economy V2 TurboLoading](/zh-CN/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)
- [Economy V2 针对性优惠](/zh-CN/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)