PlayFab のアイテムとインベントリの概要
Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラム を参照してください。
主要な概念
- カタログ - カタログは、ゲーム内で利用可能なすべてのアイテムのコレクションです。カタログを使用すると、ゲームの仮想アイテムを簡単に管理できます。詳細については、カタログの概要 を参照してください。
- カタログ アイテム – カタログで定義された個別のアイテム。武器、衣装、パワーアップ、ルート ボックスなど、あらゆる種類の仮想商品を表すことができます。ゲーム デザインに合わせて、プロパティと動作をカスタマイズできます。
- カタログ ストア - ストアを使用すると、シーズナル イベント、プロモーション、テストなど、さまざまな目的で複数のアイテム リストを作成できます。ストア を参照してください。
- バンドル - バンドルは、他のアイテムへの参照を含むカタログ アイテムです。プレイヤーがバンドルを購入すると、参照されたアイテムがアンパックされてインベントリに追加されます。
- サブスクリプション - サブスクリプションは、耐久財への期間ベースのアクセスを付与します。サブスクリプション内のアイテムは、サブスクリプションの期間中プレイヤーのインベントリで利用できます。サブスクリプション を参照してください。
- プレイヤー インベントリ コレクション - インベントリは、プレイヤーがゲーム内で所有するアイテムの記録です。アイテムの数量、仮想通貨の残高、カスタム プロパティに関する情報が含まれます。すべてのプレイヤー アカウントは、コレクション と呼ばれる 1 つ以上のインベントリを持つことができます。
- スタック - スタックにより、同じアイテムの複数の異なるインスタンスを 1 つのインベントリ内に存在させることができ、それぞれ独自の数量とカスタム プロパティを持ちます。スタック を参照してください。
- 仮想通貨 - 仮想通貨は、ゲーム内で交換手段として使用されるアイテム タイプです。仮想通貨を使用して、カタログやストアからアイテムを購入したり、アプリ内購入からのソフト通貨を実装したり、ゲームプレイの仕組みを動かしたりできます。
主要な API
ゲーム内でアイテムやインベントリを操作するための豊富な API が用意されています。これらの API を使用して、アイテムの購入、アイテムの付与、インベントリの更新、プレイヤー間のアイテム転送、取引履歴のクエリなどのアクションを実行できます。インベントリ管理
- GetInventoryItems - エンティティの現在のインベントリを取得します。
ContinuationTokenによるページングと、TurboLoading 経由の一括読み込みをサポートします。 - AddInventoryItems - プレイヤーのインベントリに直接アイテムを追加します。
- SubtractInventoryItems - プレイヤーのインベントリ内のアイテムの数量を減らします。
- UpdateInventoryItems - アイテムの数量を設定するか、インベントリ アイテムの 表示プロパティ を変更します。
- DeleteInventoryItems - プレイヤーのインベントリからアイテムのスタック全体を削除します。
購入と取引
- PurchaseInventoryItems - 仮想通貨を使用してカタログ アイテムまたはバンドルを購入します。プレイヤーのインベントリから通貨を差し引き、購入したアイテムを付与します。
- TransferInventoryItems - プレイヤー間、プレイヤーのインベントリ コレクション間、同じインベントリ内のスタック間でアイテムを転送します。
バッチ操作
- ExecuteInventoryOperations - 最大 10 個のインベントリ操作 (Add、Subtract、Update、Purchase、Transfer、Delete) を単一のアトミック リクエストにバッチ処理します。いずれかの操作が失敗すると、バッチ全体がロールバックされます。
履歴と診断
- GetTransactionHistory - プレイヤーのインベントリから取引イベントを取得します。タイムスタンプによるフィルタリングとページングをサポートし、完全な操作履歴を確認できます。取引履歴 を参照してください。
信頼性
- べき等性 - すべてのインベントリ API は
IdempotencyIdパラメーターをサポートしており、副作用の重複なしにリクエストを安全に再試行できます。ID は 14 日間強制されます。べき等性 を参照してください。