Skip to main content

商店快速入门(旧版 Economy)

Economy v1 API 处于维护模式,不会接收任何新功能,只有 bug 修复。**v1 API 在可预见的将来将持续维护。**参见 Economy v2 概览,了解有关 PlayFab Economy 下一版本的更多信息!
商店是让玩家在你的游戏中购买物品的最佳方式。 物品快速入门所示,PlayFab 支持从目录购买物品,但大多数游戏并不是这样构建购买流程的。无论你在制作放置类点击游戏、RPG、FPS 还是无尽跑酷游戏,你的游戏中很可能都有商家。玩家可以购买武器、盔甲或跑步鞋的地方。 我们针对游戏内商家和店铺的解决方案是商店 (Stores),它是你的目录的一个子集,价格可以被覆盖。 在本商店快速入门中,你将:
  • 使用普通价格向目录添加物品。
  • 创建一个包含相同物品但价格折扣的商店。
  • 使用 PlayFab API 从商店购买物品。
  • 使用 Game Manager 中的信息确认物品是以折扣商店价格购买的。

向目录添加物品

首先,让我们向你的目录中添加一些要出售的物品:
  1. 打开 Game Manager,并在左侧栏中选择 Economy
  2. 选择 Catalogs 选项卡,并打开你的 main 目录。
  3. 选择几次 New Item,并创建一些物品:
    • apricotGD 价格为 4
    • pearGD 价格为 3
    • grape,没有 GD 价格(不选择任何价格)。
你不必为目录中的物品分配虚拟货币价格,它们也可以出现在商店中。
在以下示例中,一个名为 apricot 的物品以 GD 价格 4 添加到 main 目录。

创建商店

你的目录中现在应该有一些带价格的物品。让我们创建一个商店把它们卖给玩家。
  1. 打开你的 main 目录并选择 Stores
  2. 选择 New store
  3. Store IdStore name 设置为 fruits(如以下示例所示)。
  4. 选择 ADD TO STORE
    • 弹出屏幕(如下所示)将显示当前目录中所有的物品、捆绑包和容器。
  5. 通过选择物品旁边的 Add 按钮,向你的商店添加一些物品。

为物品设置商店价格

你现在应该在 STORE CONTENTS 中看到列出的物品,但在至少设置一个价格之前,它们无效。 价格文本框旁边的小静态数字(例如 < 4)是原始目录价格。你每行只需要在一个框中输入价格,但你可以根据需要输入多个价格。
  • 如果你没有为物品输入任何价格,则会将其从商店移除。
  • 如果商店物品没有某种货币的价格,则无法使用该货币购买该物品。
  • 商店价格可以高于目录价格,并且零是物品的有效价格。
你可以拖放商店内容中的行来重新排列物品的顺序。
  1. 为你的物品添加一些 GD 价格,但使其低于目录价格:
    • Apricot: 3
    • Pear: 2
    • Grape: 1
  2. 完成后选择 SAVE STORE
在以下示例中,一个名为 apricot 的物品,其目录价格为 4 GD,被给予 3 GD 的商店价格。

从商店购买物品

现在你有了一个商店,让我们使用 PlayFab API 在游戏中从商店购买物品。
  1. 通过使用以下请求参数调用 GetStoreItems 来获取你的商店:
    • CatalogVersion = "main"
    • StoreId = "fruits"
  2. GetStoreItemsResult 中的 Store 字段应包含你的商店物品列表及其价格。
  3. 使用请求中指定你想要购买物品的货币和商店价格的值来调用 PurchaseItem
    • CatalogVersion = "main"
    • StoreId = "fruits"
    • ItemId = "pear"
    • VirtualCurrency = "GD"
    • Price = 2
如果在调用 PurchaseItem 时未指定 StoreId,则会尝试按目录价格购买。

确认购买价格

打开 Game Manager,确认购买是以两个 GD 的商店价格进行的。
  1. 从左侧栏选择 Players 打开 Players 选项卡。
  2. 选择购买了物品的玩家的 ID
  3. 检查该玩家的以下信息:
    • 打开 Inventory 选项卡。库存中现在应该包含一个 pear
    • 打开 Virtual Currency 选项卡。检查虚拟货币 Amount,以验证玩家只花费了 2 GD。
    • 打开 PlayStream 选项卡。你将看到显示从商店购买流程的事件。事件包括玩家虚拟货币物品购买事件,以及显示虚拟货币余额变化了两个 GD 的玩家虚拟货币余额变化事件。
你可以随时使用 Game Manager 更改商店中物品的顺序并调整价格。

后续步骤

你现在已经学习了如何在游戏中创建和使用商店,可以准备探索一些商店的更高级用法。 例如,通过将分组与商店结合使用,你可以在不修改游戏代码的情况下为某些玩家提供特殊价格。
最后修改于 2026年8月13日