Skip to main content

物品快速入门(旧版 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 5apple
  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年8月13日