Economy v2 ストア

  • [アーティクル]

Important

エコノミー v2 が一般提供になりました。 サポートとフィードバックについては、PlayFab フォーラムをご利用ください。

ストアは、ゲーム内エコノミーを発展させ開発するための優れた方法です。 ストアは、アイテムと価格の一覧を保管し、アイテムの基本カタログ価格を上書きできる特別なアイテムの種類です。 ストアを使用して、ゲーム内でアイテムを購入できる場所を管理したり、ゲーム内の割引やプロモーションを提供したりできます。

ストアの作成

ストアを作成するには、まず、ゲームでアクセスまたは購入可能にする他のカタログ アイテム、通貨、または UGC が公開されていることを確認する必要があります。 「Economy v2 クイック スタート」の手順に従ってください

  1. [Economy> カタログ (V2)].に移動します

  2. [ストア] タブで 、[新しいストア] を選択します。

希望のメタデータを入力します。設定する重要な項目に、このストアで利用できるようにするアイテムと、そのアイテムの上書きする価格があります。

上記は、LaserSword と WeaponBundle の 2 つのアイテムを販売するストアです。 どちらのアイテムも、基本価格がすでにカタログで定義されている既存のカタログ アイテムです。 このストアは既存の価格を上書きし、LaserSword を 1 Diamond で、WeaponBundle を 10 ゴールドと 10 シルバーで提供します。

この要求は、ストアが作成および公開されたことを示す応答を返します。

{
  "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 ダイヤモンドのコストと一致するようになりました。

ストアの検索

SearchItems API を使用する場合、渡すことができるプロパティの 1 つに Store パラメーターがあります。 このパラメーターを使用すると、ストアのコンテキスト内で検索できます。 特定のストアにアイテムがあるかどうかを確認できるだけでなく、ストアのアイテムやコンテンツの上書きされた価格を表示するためにも使用できます。 ストアの AlternateId を使用して検索することもできます。

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