アイテムのクイックスタート (レガシー Economy)

Economy v1 API はメンテナンスモードにあり、新機能は追加されず、バグ修正のみが行われます。v1 API は当面の間維持されます。 次のバージョンの PlayFab Economy の詳細については、Economy v2 の概要を参照してください。

Items のクイックスタートは、ゲーム内経済の構成要素である仮想通貨、カタログ、アイテム、購入を提供します。このクイックスタートでは、次のことを行います。

仮想通貨のセットアップ

PlayFab は、複数の通貨とアイテムを持つ堅牢なゲーム経済をサポートしています。これらの機能にアクセスし、仮想通貨を作成するには:

Game Manager を開き、左側のサイドバーで Economy を選択します。
Currency タブを選択し、New Currency を選択します (以下に示す New Currency 画面が開きます)。
仮想通貨を作成するには、以下のフィールドを編集します。
- Currency code (2 uppercase characters) を GD に設定します。
- Display name を Gold に設定します。
SAVE CURRENCY を選択します。

プレイヤーに仮想通貨を直接付与できます。例として、Game Manager を使用してプレイヤーにお金を追加しましょう。

クライアントに AddUserVirtualCurrency API を呼び出す機能を与えるのは危険な場合があります。特定の API に制限を設定する方法については、API アクセスポリシーを参照してください。

これでプレイヤーは 100 ゴールドを持っています。何ができるでしょうか? アイテムを買います。

使えないお金を持っていても意味がありません! ゲームをリリースするプラットフォームやメジャーバージョン番号など、好きなものに対応するカタログ (アイテムのコレクション) を作成できます。

アイテムのタイプを区別するために複数のカタログを作成することはお勧めしません。クラス、タグ、ストアを使用することで、より効果的にアイテムをフィルターできます。

アイテムを持つカタログを作成するには:

左側のサイドバーで Economy を選択し、Catalogs タブを選択します。
New Catalog ボタンを選択し、Catalog version として main を入力します。ID が One のアイテムが自動的に追加されます。
One を選択します (以下に示す Edit Catalog Item 画面が開きます)。以下のフィールドを編集します。
- Item ID を apple に設定します。
- Display name を apple に設定します。
- Description を Perfectly normal apple に設定します。

フォームの下部には PRICES セクションがあり、ゲームの仮想通貨でアイテムのコストを定義します。

PlayFab API を使用してゲーム内で購入を行いましょう。

プレイヤーに仮想通貨を付与するで 100 ゴールドの仮想通貨が割り当てられたプレイヤーとしてサインインします。
以下のパラメーターをリクエストに含めて GetCatalogItems を呼び出します。
- CatalogVersion = "main"
結果の Catalog に、GD 価格 5 の apple が含まれていることを確認します。
以下のパラメーター値をリクエストに含めて PurchaseItem を呼び出し、リンゴを購入します。
- CatalogVersion = "main"
- ItemId = "apple"
- VirtualCurrency = "GD"
- Price = 5
最後に、GetUserInventory を呼び出し、そのメソッドの結果を確認します。プレイヤーのインベントリのアイテム配列に、リンゴが表示されるはずです。

Game Manager で購入を確認するには:

確認するには:

PlayStream タブを開きます。Player virtual currency item purchased イベントが表示されるはずです。
Inventory タブを開きます。インベントリにリンゴが含まれるはずです。Inventory タブの機能を使用して、アイテムを取り消したり、プレイヤーに さらに リンゴを付与したりすることもできます。
Virtual Currency タブを開きます。プレイヤーには 95 ゴールドだけが残っているはずです。