跳转到主要内容

物品快速入门(旧版 Economy)

Economy v1 API 处于维护模式,不会接收任何新功能,只有 bug 修复。**v1 API 在可预见的将来将持续维护。**参见 Economy v2 概览,了解有关 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。
Save New Currency

向玩家授予虚拟货币

你可以直接向玩家授予虚拟货币。例如,我们使用 Game Manager 向玩家添加货币:
  1. 在左侧栏中选择 Players,然后选择某个玩家的 ID。
  2. 转到该玩家的 Virtual Currency 选项卡。
  3. 选择 GD 货币(打开如下所示的 Modify Virtual Currency 屏幕)。
  4. 将 Amount 更改为 100。
  5. 选择 SAVE VIRTUAL CURRENCY。
Modify Currency
让客户端可以调用 AddUserVirtualCurrency API 可能存在风险。有关设置特定 API 限制的信息,请参阅 API 访问策略。
现在该玩家有 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。
Add to Catalog

使用虚拟货币购买物品

让我们使用 PlayFab API 在你的游戏中进行购买。
  1. 以之前被授予 100 金币虚拟货币的玩家身份登录(如向玩家授予虚拟货币中所述)。
  2. 使用请求中的以下参数调用 GetCatalogItems:
    • CatalogVersion = "main"
  3. 验证结果中的 Catalog 包含价格为 GD 5 的 apple。
  4. 通过使用以下请求参数调用 PurchaseItem 来购买 apple:
    • CatalogVersion = "main"
    • ItemId = "apple"
    • VirtualCurrency = "GD"
    • Price = 5
  5. 最后,调用 GetUserInventory,查看该方法的结果。在玩家库存的物品数组中,你应该会看到一个 apple!

确认购买成功

要在 Game Manager 中确认购买:
  1. 从左侧栏选择 Players 打开 Players 选项卡。
  2. 选择购买了物品的玩家的 ID。
要确认:
  • 打开 PlayStream 选项卡。你应该会看到一个玩家虚拟货币物品购买事件。
  • 打开 Inventory 选项卡。库存中现在应该包含一个 apple。你还可以使用 Inventory 选项卡上的功能撤销物品,或向玩家授予_更多_ apple。
  • 打开 Virtual Currency 选项卡。玩家应该只剩 95 金币。
最后修改于 2026年10月20日