Economy v2 の固定コンテンツのコンテナ

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

Economy v1 (レガシー) には、組み込みの コンテナ 機能がありました。これは、開くとその内容がプレイヤーのインベントリに付与される特殊なカタログアイテムです。Economy v2 はコンテナをネイティブなアイテムタイプとして含みませんが、仮想通貨とバンドルの組み合わせを使用することで、固定コンテンツのコンテナ (常に同じアイテムを付与するコンテナ) と同じ動作を実現できます。

仕組み

このパターンは、Economy v2 の 3 つの構成要素を使用します。

コンテナ自体を表す 仮想通貨 (またはスタック可能なアイテム) — たとえば “Treasure Chest Token”。
その通貨 1 個で価格設定された、コンテナが付与すべきアイテムを含む バンドル。
プレイヤーが 1 個のトークンを使ってバンドルを購入する 購入呼び出し。これにより、アイテムが自動的にアンパックされて付与されます。

プレイヤーの視点では、(ゲームプレイの報酬、ストア購入などを通じて) トークンを受け取り、それを “開いて” 中身のアイテムを取得します。これは V1 のコンテナがまさにそのように動作していたのと同じです。

前提条件

PlayFab 開発者アカウント。
Game Manager で作成されたタイトル。
コンテナに付与させたい少なくとも 1 つの公開済みカタログアイテム。

ステップ 1: コンテナ用の仮想通貨を作成する

コンテナを表す仮想通貨を作成します。この通貨の各単位は、1 つの未開封コンテナとして機能します。

Game Manager

Economy > Catalog (V2) > Currency に移動します。
New currency を選択します。
Title を Treasure Chest などの説明的な名前に設定します。
FriendlyId を tc などの短いコードに設定します。
Save and publish を選択します。

REST API

CreateDraftItem を呼び出します。

{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "tc"
      }
    ],
    "Title": {
      "NEUTRAL": "Treasure Chest"
    },
    "Description": {
      "NEUTRAL": "A treasure chest that can be opened to reveal its contents."
    },
    "StartDate": "2023-07-27T00:00:00.000Z"
  },
  "Publish": true
}

ステップ 2: 1 個のコンテナトークンで価格設定されたバンドルを作成する

コンテナが付与すべきアイテムを含むバンドルを作成します。バンドルの価格をコンテナ通貨のちょうど 1 個に設定します。

Game Manager

Economy > Catalog (V2) > Bundles に移動します。
New bundle を選択します。
Title を、コンテナの内容を表す Treasure Chest Contents などに設定します。
Items の下で、コンテナに付与させたいアイテムと数量 (たとえば 1 個の Legendary Sword と 100 個の Gold) を追加します。
Price の下で、コンテナ通貨 (Treasure Chest) の 1 個を価格として設定します。
Save and publish を選択します。

REST API

CreateDraftItem を呼び出します。

{
  "Item": {
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "Treasure Chest Contents"
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
    "ItemReferences": [
      {
        "Id": "{{LegendarySwordID}}",
        "Amount": 1
      },
      {
        "Id": "{{GoldCurrencyID}}",
        "Amount": 100
      }
    ],
    "PriceOptions": {
      "Prices": [
        {
          "Amounts": [
            {
              "ItemId": "{{TreasureChestCurrencyID}}",
              "Amount": 1
            }
          ]
        }
      ]
    }
  },
  "Publish": true
}

プレイヤーがこのバンドルを購入すると、バンドルは自動的にアンパックされます。個々のアイテムはプレイヤーのインベントリに直接送られます。

ステップ 3: コンテナトークンをプレイヤーに付与する

ゲームデザインに合った任意の仕組みを通じて、プレイヤーにコンテナ通貨を付与します。

ゲームプレイの報酬 — レベル、クエスト、アチーブメントの完了後に AddInventoryItems を使用してトークンを付与します。
ストア購入 — ストアでコンテナトークンを別の仮想通貨または実際のお金と交換に販売します。
バトルパス / シーズナル報酬 — 報酬層としてトークンを含めます。

3 個の Treasure Chest トークンを付与するために AddInventoryItems を使用する例:

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "{{PlayerID}}"
  },
  "Item": {
    "Id": "{{TreasureChestCurrencyID}}"
  },
  "Amount": 3
}

ステップ 4: コンテナを開く

プレイヤーがコンテナを開きたいときは、PurchaseInventoryItems を呼び出して 1 個のコンテナトークンでバンドルを購入します。

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "{{PlayerID}}"
  },
  "Item": {
    "Id": "{{TreasureChestContentsBundleID}}"
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{TreasureChestCurrencyID}}",
      "Amount": 1
    }
  ]
}

呼び出しが成功すると、プレイヤーのインベントリが更新されます: 1 個の Treasure Chest トークンが差し引かれ、バンドルの内容 (1 個の Legendary Sword + 100 個の Gold) が追加されます。

複数のコンテナタイプ

このパターンを繰り返して、複数のコンテナタイプを作成します。たとえば:

コンテナ	通貨 (FriendlyId)	バンドルの内容
Treasure Chest	`tc`	1 個の Legendary Sword + 100 個の Gold
Supply Crate	`sc`	5 個の Health Potion + 3 個の Mana Potion
Premium Box	`pb`	1 個の Rare Mount + 500 個の Gold + 50 個の Gem

各コンテナタイプには独自の通貨とバンドルがあります。

コンテナ購入にストアを使用する

ストアを使用してコンテナバンドルの価格を上書きします。ストアを使用することで、異なるコンテキスト (たとえばイベント中の割引された “開封” コスト) で同じコンテナを異なる価格で提供できます。

{
  "Item": {
    "Type": "store",
    "Title": {
      "NEUTRAL": "Event Store"
    },
    "ItemReferences": [
      {
        "Id": "{{TreasureChestContentsBundleID}}",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [
            {
              "Amounts": [
                {
                  "ItemId": "{{TreasureChestCurrencyID}}",
                  "Amount": 1
                }
              ]
            }
          ]
        }
      }
    ]
  },
  "Publish": true
}

次に、購入時に StoreId を渡します。

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "{{PlayerID}}"
  },
  "Item": {
    "Id": "{{TreasureChestContentsBundleID}}"
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{TreasureChestCurrencyID}}",
      "Amount": 1
    }
  ],
  "StoreId": "{{EventStoreID}}"
}

制限事項

このパターンは、固定の決定論的なコンテンツ を持つコンテナに機能します。ランダム化されたルート (コンテナを開くたびに内容が変わる、ドロップテーブルと組み合わせた V1 のコンテナに似たもの) が必要な場合は、ドロップテーブルとランダム化されたルートのチュートリアルを参照してください。このチュートリアルでは、Azure Functions を使用して次を行います。

プレイヤーのインベントリからコンテナトークンを減算します。
重み付けランダム選択ロジックを実行します。
結果として得られたアイテムをインベントリ API を介して付与します。

XBOX Services

PlayFab

仕組み

前提条件

ステップ 1: コンテナ用の仮想通貨を作成する

Game Manager

REST API

ステップ 2: 1 個のコンテナトークンで価格設定されたバンドルを作成する

Game Manager

REST API

ステップ 3: コンテナトークンをプレイヤーに付与する

ステップ 4: コンテナを開く

複数のコンテナタイプ

コンテナ購入にストアを使用する

制限事項

関連項目

​仕組み

​前提条件

​ステップ 1: コンテナ用の仮想通貨を作成する

​Game Manager

​REST API

​ステップ 2: 1 個のコンテナ トークンで価格設定されたバンドルを作成する

​Game Manager

​REST API

​ステップ 3: コンテナ トークンをプレイヤーに付与する

​ステップ 4: コンテナを開く

​複数のコンテナ タイプ

​コンテナ購入にストアを使用する

​制限事項

​関連項目

仕組み

前提条件

ステップ 1: コンテナ用の仮想通貨を作成する

Game Manager

REST API

ステップ 2: 1 個のコンテナトークンで価格設定されたバンドルを作成する

Game Manager

REST API

ステップ 3: コンテナトークンをプレイヤーに付与する

ステップ 4: コンテナを開く

複数のコンテナタイプ

コンテナ購入にストアを使用する

制限事項

関連項目