アイテムとインベントリは、魅力的でイマーシブなゲームを作成するための重要な機能です。 カスタマイズ オプション、報酬、進行状況システム、収益化の機会をプレイヤーに提供できます。
PlayFab は、これらの仮想商品を作成および管理するための柔軟で強力なプラットフォームを提供します。 PlayFab を使用して、持続性、消耗品、バンドル、コンテナーなど、さまざまな種類のアイテムを定義できます。 PlayFab を使用して、プレイヤーによるアイテムの所有権と使用状況を追跡することもできます。 PlayFab のアイテムとインベントリについて知っておくべき重要な概念を次に示します。
Important
Economy v1 API はメンテナンス モードであり、新機能は受け取らず、バグ修正のみを受け取ります。 v1 API は、当面維持されます。 次のバージョンの PlayFab エコノミーの詳細については、｢エコノミー v2 の概要」をご覧ください。
主要概念
- カタログ - カタログは、ゲームで使用できるすべてのアイテムのコレクションです。 カタログは、ゲームの仮想アイテムを管理する簡単な方法です。
- カタログアイテム – カタログアイテムは、カタログで定義する個々のアイテムです。 武器、衣装、パワーアップ、戦利品ボックスなど、ゲームで提供したいあらゆる種類の仮想アイテムを表すことができます。ゲームのデザインに合わせて、カタログ アイテムのプロパティと動作をカスタマイズできます。
- カタログ ストア - 季節のイベント、プロモーション、テストなど、さまざまな目的で複数のアイテム登録情報を作成するストアを使用できます。
- プレイヤー インベントリ コレクション - インベントリは、プレイヤーが所有しているアイテム、またはゲームで使用したアイテムのレコードです。 また、プレイヤーの仮想通貨残高とアイテム履歴に関する情報も含まれています。 すべてのプレイヤー アカウントは 1 つ以上のインベントリを持つことができ、これをインベントリ コレクションと呼びます。
- 仮想通貨 - 仮想通貨は、ゲーム内の交換手段として使用できるアイテムの一種です。 通常、仮想通貨を使用して、カタログまたはストアから他のアイテムを販売または購入します。 また、仮想通貨を使用して、アプリ内購入からのソフト通貨換算を実装したり、ゲームプレイの仕組みを推進したりすることもできます。
これらおよびその他の関連概念の詳細については、Economy V2 カタログの概要を参照してください。
キー API
PlayFab は、アイテムとインベントリを操作するための大規模な対話型プレイ フィールドを提供します。また、カタログ内のアイテムの定義は大幅なカスタマイズが可能です。 ゲーム内のアイテムやインベントリを操作するために、豊富な API セットを使用できます。 これらの API を使用すると、アイテムの購入、アイテムの付与、アイテムの使用、在庫の更新、インベントリの照会など、さまざまなアクションを実行できます。 最も一般的な対話は、以下のような少数の主要な API を介して行われます。
- PurchaseInventoryItems - この API を使用すると、プレイヤーは仮想通貨でカタログアイテムまたはバンドルを購入できます。 プレイヤーのインベントリから通貨を差し引き、プレイヤーのインベントリにアイテム インスタンスを追加します。
- GetInventoryItems - エンティティの現在のインベントリを取得し、指定したプレイヤーのアイテム インスタンスのリストを返します。
- UpdateInventoryItems - 特にカスタム属性を変更するための DisplayProperties に対して、インベントリ項目を簡単に変更するために使用されます。
- GetTransactionHistory - インベントリから最新のトランザクション イベントを取得し、ページスルーして完全なトランザクション履歴を取得できるようにします。
これらの API およびその他の関連 API の使用方法の詳細については、PlayFab Inventory API のドキュメントを参照してください。