> ## 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（旧版）快速入门

> PlayFab 旧版 Economy (v1) 快速入门，涵盖初始目录设置、虚拟货币配置以及基本的物品和商店创建。

# 快速入门（旧版 Economy）

<Info>
  Economy v1 API 处于维护模式，不会接收任何新功能，只有 bug 修复。\*\*v1 API 在可预见的将来将持续维护。\*\*参见 [Economy v2 概览](/services/playfab/economy-monetization/economy-v2/overview)，了解有关 PlayFab Economy 下一版本的更多信息！
</Info>

让变现有效运作是游戏中最大的挑战之一。PlayFab 通过在三个基础组件之上进行构建来简化这种体验：货币、物品和库存。

在本快速入门中，你将：

1. 设置一种虚拟货币。
2. 创建一个物品。
3. 将物品添加到玩家的库存。
4. 了解自定义你的经济体系的后续步骤。

## 设置虚拟货币

虚拟货币是游戏内经济的基础。玩家和角色可以被授予这些货币，然后可用于购买或交易物品。

物品的价格可以是虚拟货币或真实货币。每个游戏都可以支持多种任意虚拟货币，为你的游戏提供实现任何交换媒介的灵活性（例如金币、宝石、爱心或星际信用点）。

要创建虚拟货币：

1. 打开 **Game Manager**，并在左侧栏中选择 **Economy**。
2. 选择 **Currency** 选项卡。
3. 选择 **New Currency** 并更改以下字段（如下图所示）：
   * 将 **Currency code (2 uppercase characters)** 设置为 **GD**。
   * 将 **Display name** 设置为 **Gold**。
4. 选择 **SAVE CURRENCY**。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="Create Item" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

现在货币已经设置好，就可以为目录物品分配对应于该虚拟货币的价格。

## 创建物品

许多游戏为玩家提供可购买的物品，例如护盾、关卡解锁或增益道具。这些物品在目录中指定。在玩家可以从目录购买物品之前，你必须创建物品来填充目录。

要创建一个包含物品的目录：

1. 在左侧栏中选择 **Economy** 并选择 **Catalogs** 选项卡。

2. 选择 **NEW CATALOG** 按钮，并输入 **main** 作为 **Catalog version**。会自动添加一个 ID 为 **One** 的物品。

3. 选择 **One** 并更改以下字段（如下图所示）：

   * 将 **Item ID** 设置为 **apple**。
   * 将 **Display name** 设置为 **apple**。
   * 将 **Description** 设置为 **Perfectly normal apple**。

4. **PRICES** 部分位于表单底部。

5. 将 apple 的价格以金币（**GD**）设置为 **5**。

6. 选择 **SAVE ITEM** 按钮。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b07c6dc306edea1d41c9a4d73f5c3915" alt="Edit or Save Currency" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/create-item.png" />

## 向玩家库存添加物品

PlayFab 的 [Player Item Management (Server)](xref:titleid.playfabapi.com.server.playeritemmanagement) 和 [Player Item Management (Client)](xref:titleid.playfabapi.com.client.playeritemmanagement) API 支持多种物品购买策略：

* 真实货币
* 虚拟货币
* 基于购买其他物品的触发式物品授予
* 已锁定（带有可掉落/可购买钥匙）和已解锁的盒子
* 随机结果表
* 基于游戏内付费或免费事件授予的不可购买物品
* 以及更多场景，尤其是通过 [使用 Azure Functions 的 PlayFab CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)

**通过用虚拟货币购买将物品添加到玩家库存。**

1. 在你的游戏中，以已被授予虚拟货币的玩家身份登录。（如需，请参阅[向玩家授予虚拟货币](/services/playfab/economy-monetization/economy/items/quickstart#giving-virtual-currency-to-a-player)以获取更多信息。）

2. 使用请求中的以下参数调用 [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems)：
   * `CatalogVersion = "main"`

3. 验证结果中的 `Catalog` 包含价格为 **GD** **5** 的 **apple**。

4. 调用 [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) 来购买 **apple**，请求中使用以下参数值：

   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency  = "GD"`
   * `Price =  5`

5. 最后，调用 [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) 并查看该方法的结果。在玩家 `Inventory` 中的物品数组中，你应该会看到一个 apple！

## 自定义经济体系的后续步骤

一旦你拥有由虚拟货币支持的物品的目录，你可以通过以下方式点亮你的经济：

* **真实世界购买**：我们的 [PlayFab、Unity IAP 和 Android 入门](/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android)以及[非收据支付处理](/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing)教程帮助你将虚拟经济与现有商店连接。
* **利用你的目录**：创建捆绑包、容器和掉落表。有关更多信息，请参阅我们的[目录](/services/playfab/economy-monetization/economy/items/catalogs)教程。
* **使用物品属性**：定义多种价格并指定可堆叠、可交易和限量版[物品](/services/playfab/economy-monetization/economy/items)。
* **设置独特的游戏内商家或促销活动**：使用[商店和促销](/services/playfab/economy-monetization/economy/tutorials/stores-and-sales)。
* **创建一些玩家分组并使用商店**：无论玩家处于你的游戏生命周期的哪个阶段，都可以向他们推送不同的物品和捆绑包优惠。有关示例，请参阅我们的[玩家分组的自定义商店](/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments)教程。
* **收集经济数据**：使你能够使用 PlayFab [报告](/services/playfab/data-analytics/learn-data/reports/overview)改进和迭代你的游戏。


## Related topics

- [物品（旧版 Economy）快速入门](/zh-CN/services/playfab/economy-monetization/economy/items/quickstart.md)
- [商店（旧版 Economy）快速入门](/zh-CN/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [快速入门](/zh-CN/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [交易快速入门](/zh-CN/services/playfab/economy-monetization/economy/trading/trading-quickstart.md)
- [锦标赛与排行榜快速入门](/zh-CN/services/playfab/community/leaderboards/tournaments-leaderboards/quickstart.md)