物品快速入门(旧版 Economy)
Economy v1 API 处于维护模式,不会接收任何新功能,只有 bug 修复。**v1 API 在可预见的将来将持续维护。**参见 Economy v2 概览,了解有关 PlayFab Economy 下一版本的更多信息!
- 为你的游戏设置一种虚拟货币。
- 向玩家授予虚拟货币。
- 向你的游戏内目录添加一个物品。
- 使用 PlayFab API,用虚拟货币从目录购买一个物品。
- 使用 Game Manager 中的信息确认购买成功。
设置虚拟货币
PlayFab 支持带有多种货币和物品的健全的游戏经济。 要访问这些功能并创建虚拟货币:- 打开 Game Manager,并在左侧栏中选择 Economy。
- 选择 Currency 选项卡,然后选择 New Currency(打开如下所示的 New Currency 屏幕)。
- 要创建你的虚拟货币,编辑以下字段:
- 将 Currency code (2 uppercase characters) 设置为 GD。
- 将 Display name 设置为 Gold。
- 选择 SAVE CURRENCY。

向玩家授予虚拟货币
你可以直接向玩家授予虚拟货币。例如,我们使用 Game Manager 向玩家添加货币:- 在左侧栏中选择 Players,然后选择某个玩家的 ID。
- 转到该玩家的 Virtual Currency 选项卡。
- 选择 GD 货币(打开如下所示的 Modify Virtual Currency 屏幕)。
- 将 Amount 更改为 100。
- 选择 SAVE VIRTUAL CURRENCY。

向你的游戏内目录添加物品
有钱却不能花,那有什么意义呢! 你可以创建与你发布游戏所在的平台或主要版本号对应的目录(一组物品)——按你喜欢的方式。 要创建一个带有物品的目录:- 在左侧栏中选择 Economy 并选择 Catalogs 选项卡。
- 选择 New Catalog 按钮,并输入 main 作为 Catalog version。会自动添加一个 ID 为 One 的物品。
- 选择 One(打开如下所示的 Edit Catalog Item 屏幕)。编辑以下字段:
- 将 Item ID 设置为 apple。
- 将 Display name 设置为 apple。
- 将 Description 设置为 Perfectly normal apple。
- 将 apple 的价格以金币(GD)设置为 5。
- 选择 SAVE ITEM。

使用虚拟货币购买物品
让我们使用 PlayFab API 在你的游戏中进行购买。- 以之前被授予 100 金币虚拟货币的玩家身份登录(如向玩家授予虚拟货币中所述)。
- 使用请求中的以下参数调用 GetCatalogItems:
CatalogVersion = "main"
- 验证结果中的
Catalog包含价格为 GD 5 的 apple。 - 通过使用以下请求参数调用 PurchaseItem 来购买 apple:
CatalogVersion = "main"ItemId = "apple"VirtualCurrency = "GD"Price = 5
- 最后,调用 GetUserInventory,查看该方法的结果。在玩家库存的物品数组中,你应该会看到一个 apple!
确认购买成功
要在 Game Manager 中确认购买:- 从左侧栏选择 Players 打开 Players 选项卡。
- 选择购买了物品的玩家的 ID。
- 打开 PlayStream 选项卡。你应该会看到一个玩家虚拟货币物品购买事件。
- 打开 Inventory 选项卡。库存中现在应该包含一个 apple。你还可以使用 Inventory 选项卡上的功能撤销物品,或向玩家授予_更多_ apple。
- 打开 Virtual Currency 选项卡。玩家应该只剩 95 金币。
