物品快速入门（旧版 Economy）

重要

经济 v1 API 处于维护模式，将不会收到任何新功能，只有 bug 修复。 v1 API 将在可预见的未来进行维护。 请参阅 Economy v2 概述 ，详细了解 PlayFab Economy 的下一个版本！

物品快速入门为您介绍游戏内经济的构建基块：虚拟货币、目录、物品和购买。

在本快速入门中，您将：

• 为游戏设置虚拟货币。
• 向玩家提供虚拟货币。
• 将物品添加到游戏内目录中。
• 使用 PlayFab API 通过使用虚拟货币购买目录中的物品。
• 使用 Game Manager 中的信息确认购买成功。

设置虚拟货币

PlayFab 支持具有多种货币和物品的强大游戏经济。

若要访问这些功能并创建虚拟货币：

1. 打开“Game Manager”并在左侧栏中选择“Economy”。
2. 选择“货币”选项卡，然后选择“新货币”（打开“新货币”屏幕，如下所示）。
3. 若要创建虚拟货币，请编辑以下字段：
   • 将“Currency code (2 uppercase characters)”设置为 GD。
   • 将“Display name”设置为 Gold。
4. 选择 SAVE CURRENCY。

向玩家提供虚拟货币

可以直接向玩家提供虚拟货币。 例如，让我们使用 Game Manager 为玩家添加资金：

1. 选择左侧栏中的“玩家”，然后选择玩家的 ID。
2. 转到玩家的“虚拟货币”选项卡。
3. 选择 GD 货币（打开“修改虚拟货币”屏幕，如下所示）。
4. 将“Amount”更改为 100。
5. 选择“SAVE VIRTUAL CURRENCY”。

提示

让客户端能够调用 AddUserVirtualCurrency API 可能很危险。 有关在特定 API 上设置限制的信息，请参阅 API 访问策略。

现在，玩家有 100 枚金币。 他们能用它做什么？ 购买物品！

将物品添加到游戏内目录中

如果不能花钱，钱就没有意义！

您可以创建与发布游戏的平台或主要版本号相对应的目录 - 无论您喜欢什么。您可以创建与您发布游戏的平台或主要版本号相对应的目录（项目集合）--随您喜欢。

提示

我们不建议创建多个目录来区分物品类型。 可以使用类、标记和商店更有效地筛选物品。

创建具有一个物品的目录：

1. 在左侧栏中选择“Economy”，然后选择“Catalogs”选项卡。
2. 选择“New Catalog”按钮，然后输入 main 作为 Catalog version。 ID 为 One 的物品是自动添加的。
3. 选择一个（打开编辑目录项 屏幕，如下所示）。 编辑以下字段：
   • 将 Item ID 设置为 apple。
   • 将 Display name 设置为 apple。
   • 将 Description 设置为 Perfectly normal apple。

表格底部为“价格”部分，在该部分中以游戏的虚拟货币定义物品费用。

1. 以金币 (GD) 为单位将苹果的价格设置为 5。
2. 选择“SAVE ITEM”。

使用虚拟货币购买物品

让我们使用 PlayFab API 在游戏中进行购买。

1. 以分配到 100 枚金币（虚拟货币）的玩家身份登录（如在向玩家提供虚拟货币中所述）。
2. 使用请求中的以下参数调用 GetCatalogItems：
   • CatalogVersion = "main"
3. 验证结果中的 Catalog 是否包含 GD 价格为 5 的 苹果。
4. 使用请求中的以下参数值调用 PurchaseItem 来购买此苹果：
   • CatalogVersion = "main"
   • ItemId = "apple"
   • VirtualCurrency = "GD"
   • Price = 5
5. 最后，调用 GetUserInventory 并查看该方法的结果。 在玩家的一系列物品中，可以看到一个苹果!

确认购买成功

在 Game Manager 中确认购买：

1. 从左侧栏中选择“Players”以打开“Players”选项卡。
2. 选择购买了此物品的玩家的 ID 。

确认：

• 打开“PlayStream”选项卡。您可以看到一个“Player virtual currency item purchased”事件。
• 打开“Inventory”选项卡。现在物品栏应包含一个苹果。 您还可以使用“Inventory”选项卡上的功能撤销此物品，或授予玩家更多苹果。
• 打开“Virtual Currency”选项卡。玩家应该只剩下 95 枚金币。