Economy v2 商店 - XBOX Game Development Documentation

Economy v2 现已正式发布。如需支持和反馈，请访问 PlayFab 论坛。

商店是构建和发展游戏内经济的绝佳方式。商店是一种特殊的物品类型，包含物品和价格列表，允许你覆盖物品的基础目录价格。商店可用于管理你游戏中物品可购买的位置，提供游戏内折扣和促销，以及更多！

创建商店

要创建商店，你必须首先确保已发布你希望在游戏中可访问/可购买的其他目录物品、货币或 UGC。你可以按照 Economy v2 快速入门中的步骤操作

GameManager

导航到 Economy > Catalog (V2)。
在 Stores 选项卡下，选择 New Store。

填写所需的元数据，关键要设置的项之一是你希望在此商店可用的物品，以及你希望将它们的价格覆盖为什么。

API

你可以使用 CreateDraftItem 创建商店。创建商店的 CreateDraftItem 请求示例：

{
  "Item": {
   "Type": "store",
    "Title": {
      "NEUTRAL": "My First Store",
    },
    "StartDate": "2022-09-07T00:00:00.00000000Z",
    "ItemReferences":[
      {
        "Id":"LaserSword",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [{
            "Amounts": [{
              "ItemId": "Diamond",
              "Amount": 1
            }]
          }]
        }
      },
      {
      "Id":"WeaponBundle",
      "PriceOptions": {
        "Prices": [{
          "Amounts": [{
            "ItemId": "Gold",
            "Amount": 10
            },
            {
            "ItemId": "Silver",
            "Amount": 10
          }]
        }],
      },
    }]
   },
   "Publish": true
}

上面是一个出售两件物品的商店，即 LaserSword 和 WeaponBundle。这两件物品都是已存在的目录物品，具有目录中定义的某些现有基础价格。这个商店覆盖了它们的现有价格，现在以 1 个 Diamond 提供 LaserSword，以 10 个 Gold 和 10 个 Silver 提供 WeaponBundle。此请求将返回一个响应，说明商店已创建并发布：

{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}

请注意，Id 现在与我们发布的商店关联。

为了简化概念，物品 ID 已从 GUID 换成物品名称，以更好地说明使用商店的示例。

使用商店

当玩家调用 PurchaseInventoryItems API 时使用商店。当你调用 PurchaseInventoryItems 时，可选属性之一是 StoreId 参数，我们可以传入用于应用于此购买请求的商店。使用商店的 PurchaseInventoryItems 请求示例：

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}

请注意传入购买请求的 {{StoreId}}，以及预期的 PriceAmount 现在如何匹配我们在商店中设置的 1 Diamond 成本。

搜索商店

当你使用 SearchItems API 时，你可以传入的属性之一是 Store 参数。此参数允许你在商店的上下文中进行搜索。除了能够检查特定商店中是否存在物品外，它还可用于显示商店物品/内容的覆盖价格。你也可以使用商店的 AlternateId 进行搜索。

{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}

​创建商店

​GameManager

​API

​使用商店

​搜索商店

创建商店

GameManager

API

使用商店

搜索商店