Economy v2 のストア - XBOX Game Development Documentation

Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラムを参照してください。

ストアは、ゲーム内エコノミーを構築および発展させるための優れた方法です。ストアは特殊なアイテムタイプで、アイテムと価格のリストを保持し、アイテムの基本カタログ価格を上書きできます。ストアを使用すると、ゲーム内でアイテムがどこで購入できるかを管理したり、ゲーム内の割引やプロモーションを提供したりできます。その他にもさまざまな用途があります。

ストアの作成

ストアを作成するには、まずゲーム内でアクセス可能/購入可能にしたい公開済みのカタログアイテム、Currency、または UGC が他にあることを確認する必要があります。手順は Economy v2 のクイックスタートを参照してください。

Game Manager

Economy > Catalog (V2) に移動します。
Stores タブで New Store を選択します。

必要なメタデータを入力します。設定する重要な項目の 1 つは、このストアで提供したいアイテムと、それらのアイテムを上書きしたい価格です。

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
}

上記は 2 つのアイテム、LaserSword と WeaponBundle を販売するストアです。両方のアイテムは既存のカタログアイテムであり、カタログで定義された基本価格が設定されています。このストアはそれらの既存価格を上書きし、LaserSword を 1 個の Diamond で、WeaponBundle を 10 個の Gold と 10 個の Silver で提供するようになります。このリクエストは、ストアが作成および公開されたことを示すレスポンスを返します。

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

公開されたストアに関連付けられた Id に注目してください。

概念をわかりやすくするために、ストア使用例をよりよく示すため、アイテム ID を GUID からアイテム名に置き換えています。

ストアの使用

ストアは、プレイヤーが PurchaseInventoryItems API を呼び出すときに使用されます。PurchaseInventoryItems を呼び出す際、オプションプロパティの 1 つに 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 を使用する際、渡せるプロパティの 1 つが Store パラメーターです。このパラメーターを使用すると、ストアのコンテキスト内で検索できます。特定のストアにアイテムが存在するかどうかを確認できるだけでなく、ストアのアイテム/コンテンツの上書きされた価格を表示するためにも使用できます。ストアの AlternateId を使用して検索することもできます。

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

​ストアの作成

​Game Manager

​API

​ストアの使用

​ストアの検索

ストアの作成

Game Manager

API

ストアの使用

ストアの検索