ストアのクイック スタート (レガシ エコノミー)
Important
Economy v1 API はメンテナンス モードであり、新機能は受け取らず、バグ修正のみを受け取ります。 v1 API は、当面維持されます。 次のバージョンの PlayFab Economy の詳細については、「Economy v2 の概要」を参照してください。
ストアは、プレイヤーがゲーム内でアイテムを購入できるようにする最適な方法です。
アイテムのクイックスタートに記載されるように、PlayFab ではカタログからのアイテムの購入をサポートしていますが、ほとんどのゲームでは購入を別の方法で構築します。 アイドル クリッカー、RGP、FPS、無限ランナーなど、ゲームにベンダーがいると思います。 プレイヤーが武器、防具、または実行中の靴を購入できる場所。
ゲーム内のベンダーや店舗向けのソリューションは、上書きできる価格を含むカタログのサブセットである Store です。
このクイックスタートでは、以下を実行します。
- 通常価格でアイテムをカタログに追加する。
- 価格が異なる同じアイテムを格納する ストアを作成する。
- PlayFab API を使用して、ストアからアイテムを購入する。
- ゲームマネージャーの情報を使用して、割引きされた ストア価格でアイテムが購入されたことを確認する。
カタログにアイテムを追加する
まず、カタログに販売するアイテムを追加しましょう。
- ゲーム マネージャーを開き、左側のバーで [Economy (エコノミー)] を選択します。
- [Catalogs (カタログ)] タブを選択し、[main (メイン)] カタログを開きます。
-
[New Item (新しいアイテム)] を何度か選択し、いくつかのアイテムを作成します。
- GD の価格が 4 の「あんず」。
- GD の価格が 3 の「梨」。
- GD の価格のない (価格を設定しない)「ぶどう 」。
ヒント
カタログのアイテムを ストアで表示するために、仮想通貨を割り当てる必要はありません。
以下の例では、「あんず 」というアイテムが GD 価格 4 でメインのカタログに追加されています。
ストアを作成する
これで、価格を設定したアイテムがいくつかカタログに追加されました。 これらをプレイヤーに販売するストアを作成しましょう。
- [main (メイン)] のカタログを開き、[Store (ストア)] を選択します。
- [New store (新しいストア)] を選択します。
-
[Store Id (ストア ID)] と [Store name (ストア名)] を「fruits (フルーツ)」に設定します (以下の例を参照)。
-
[ADD TO STORE (ストアに追加)] を選択します。
- 以下のようなポップアップ スクリーンに、現在のカタログのすべてのアイテム、バンドル、コンテナーが表示されます。
- アイテムの横にある [Add (追加)] を選択して、いくつかのアイテムをストアに追加します。
アイテムのストア価格を設定する
[STORE CONTENTS (ストア コンテンツ)] にアイテムが表示されますが、少なくとも 1 つの価格を設定するまで有効ではありません。
価格のテキスト ボックスの隣にある小さな静的数字 (< 4 など) は、元のカタログ価格です。 各行で価格を入力する必要があるのは 1 つのボックスのみですが、いくつでも価格を入力できます。
- アイテムに対して価格を入力しない場合、ストアから削除されます。
- ストアのアイテムに通貨での価格が設定されていない場合、その通貨で購入することはできません。
- ストア価格はカタログ価格よりも高くすることができ、ゼロもアイテムの有効な価格です。
ヒント
ストア コンテンツの行をドラッグ アンド ドロップして、アイテムの順序を変更できます。
- アイテムに GD の価格を追加しますが、カタログ価格よりも低くしてください。
- あんず: 3。
- 梨: 2。
- ぶどう: 1。
- 終了したら、[SAVE STORE (ストアの保存)] を選択します。
以下の例では、カタログ価格が 4 GD の「 あんず」というアイテムに 3 GD のストア価格が設定されています。
ストアからアイテムを購入する
ストアを作成したところで、PlayFab API を使用して、ゲーム内のストアからアイテムを購入してみましょう。
- リクエストに以下のパラメーターを入れて GetStoreItems を呼び出し、ストアを取得します。
CatalogVersion = "main"
StoreId = "fruits"
-
GetStoreItemsResultの
Store
フィールドには、ストア アイテムと価格のリストが含まれています。 - 購入するアイテムの通貨とストア価格を指定する値をリクエストに入れて、PurchaseItem を呼び出します。
CatalogVersion = "main"
StoreId = "fruits"
ItemId = "pear"
VirtualCurrency = "GD"
Price = 2
ヒント
PurchaseItem を呼び出す時に StoreId
を指定しない場合、購入はカタログ価格に対して試行されます。
購入価格を確認する
ゲーム マネージャーを開き、購入がストア価格の 2 GD で実行されたことを確認します。
- 左側のバーから [Players (プレイヤー)] を選択して、[Players (プレイヤー)] タブを開きます。
- アイテムを購入したプレイヤーの ID を選択します。
- プレイヤーの以下の情報を確認します。
- [Inventory (インベントリ)] タブを開きます。インベントリに「梨」が含まれています。
- [Virtual Currency (仮想通貨)] タブを開きます。仮想通貨の [Amount (金額)] を確認して、プレイヤーが 2 GD のみを使用したことを確認します。
- [PlayStream] タブを開きます。ストアからの購入フローを示すイベントが表示されます。 イベントには、プレイヤーによる仮想通貨アイテム購入イベントと、2 つの GD によって変更されたことを示すプレイヤーによる仮想通貨残高変更イベントが含まれます。
ヒント
ゲーム マネージャーを使用してストア内のアイテムの順序を変更したり、いつでも価格を変更したりできます。
次の手順
ゲームでストアを作成および使用する方法を学んだため、ストアの高度な使用方法を学習できます。
たとえば、ストアでセグメントを使用すると、ゲーム コードに触れることなく特定のプレイヤーに特別価格を提供できます。