Economy v2 商店 - XBOX Game Development Documentation

Economy v2 現已正式推出。如需支援與意見反應，請前往 PlayFab 論壇。

商店是建構與發展遊戲內 Economy 的絕佳方式。商店是一種特殊的項目類型，可保存項目與價格的清單，並可讓您覆寫項目的基本目錄價格。商店可用來管理項目在您遊戲中的可購買位置、提供遊戲內折扣與促銷等，還有更多用途！

建立商店

若要建立商店，您必須先確定您已有其他想要在遊戲中可存取/可購買的已發佈目錄項目、貨幣或 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

使用商店

搜尋商店