> ## 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）
Economy v1 API 处于维护模式，不会接收任何新功能，只有 bug 修复。\*\*v1 API 在可预见的将来将持续维护。\*\*参见 [Economy v2 概览](/services/playfab/economy-monetization/economy-v2/overview)，了解有关 PlayFab Economy 下一版本的更多信息！
物品快速入门为你提供构建游戏内经济的基础模块：虚拟货币、目录、物品和购买。
在本快速入门中，你将：
* 为你的游戏设置一种虚拟货币。
* 向玩家授予虚拟货币。
* 向你的游戏内目录添加一个物品。
* 使用 PlayFab API，用虚拟货币从目录购买一个物品。
* 使用 Game Manager 中的信息确认购买成功。
## 设置虚拟货币
PlayFab 支持带有多种货币和物品的健全的游戏经济。
要访问这些功能并创建虚拟货币：
1. 打开 **Game Manager**，并在左侧栏中选择 **Economy**。
2. 选择 **Currency** 选项卡，然后选择 **New Currency**（打开如下所示的 **New Currency** 屏幕）。
3. 要创建你的虚拟货币，编辑以下字段：
* 将 **Currency code (2 uppercase characters)** 设置为 **GD**。
* 将 **Display name** 设置为 **Gold**。
4. 选择 **SAVE CURRENCY**。
## 向玩家授予虚拟货币
你可以直接向玩家授予虚拟货币。例如，我们使用 Game Manager 向玩家添加货币：
1. 在左侧栏中选择 **Players**，然后选择某个玩家的 **ID**。
2. 转到该玩家的 **Virtual Currency** 选项卡。
3. 选择 **GD** 货币（打开如下所示的 **Modify Virtual Currency** 屏幕）。
4. 将 **Amount** 更改为 **100**。
5. 选择 **SAVE VIRTUAL CURRENCY**。
让客户端可以调用 [AddUserVirtualCurrency](xref:titleid.playfabapi.com.client.playeritemmanagement.adduservirtualcurrency) API 可能存在风险。有关设置特定 API 限制的信息，请参阅 [API 访问策略](/services/playfab/api-references/api-access-policy)。
现在该玩家有 100 金币。他们能用它做什么？购买物品！
## 向你的游戏内目录添加物品
*有钱却不能花，那有什么意义呢！*
你可以创建与你发布游戏所在的平台或主要版本号对应的目录（一组物品）——按你喜欢的方式。
我们不推荐创建多个目录来区分物品类型。你可以使用类、标签和商店更有效地筛选物品。
要创建一个带有物品的目录：
1. 在左侧栏中选择 **Economy** 并选择 **Catalogs** 选项卡。
2. 选择 **New Catalog** 按钮，并输入 **main** 作为 **Catalog version**。会自动添加一个 ID 为 **One** 的物品。
3. 选择 **One**（打开如下所示的 **Edit Catalog Item** 屏幕）。编辑以下字段：
* 将 **Item ID** 设置为 **apple**。
* 将 **Display name** 设置为 **apple**。
* 将 **Description** 设置为 **Perfectly normal apple**。
表单底部有 **PRICES** 部分，你可以在此定义物品在你的游戏虚拟货币中的价格。
1. 将 apple 的价格以金币（**GD**）设置为 **5**。
2. 选择 **SAVE ITEM**。
## 使用虚拟货币购买物品
让我们使用 PlayFab API 在你的游戏中进行购买。
1. 以之前被授予 100 金币虚拟货币的玩家身份登录（如[向玩家授予虚拟货币](#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)，查看该方法的结果。在玩家库存的物品数组中，你应该会看到一个 apple！
## 确认购买成功
要在 Game Manager 中确认购买：
1. 从左侧栏选择 **Players** 打开 **Players** 选项卡。
2. 选择购买了物品的玩家的 **ID**。
要确认：
* 打开 **PlayStream** 选项卡。你应该会看到一个[玩家虚拟货币物品购买](/services/playfab/api-references/events/Player/player-vc-item-purchased)事件。
* 打开 **Inventory** 选项卡。库存中现在应该包含一个 apple。你还可以使用 **Inventory** 选项卡上的功能撤销物品，或向玩家授予\_更多\_ apple。
* 打开 **Virtual Currency** 选项卡。玩家应该只剩 95 金币。