PlayFabとの統合

どのように動作するか

• エクソーラソリューションを利用するため、インゲームストアまでにPlayFabからのカタログをインポートすることができます。
• ユーザーがインゲームストアで購入したアイテムを「プレイファブ」に自動転送。

使用に適した方

• PlayFabを統合したパートナーは、エクソーラソリューションを通じてアイテム（仮想通貨と仮想アイテム）の配信エリアを増やしたいと考えています。
• エクソーラソリューションを統合し、PlayFabでアイテムを収益化したいパートナー（実際通貨でアイテムを販売する）したいパートナー。

インポートルール

PlayFabからアイテムをインポートする場合、次のロジックが適用されます：

• PlayFabで提供される耐久消費財は、仮想アイテム（仮想通貨やバンドルではなく）としてシステムに取り込まれます。
• すべてのアイテム、および仮想通貨パッケージやPlayFabバンドル内のアイテムは、消耗品（パラメータconsumable = trueまたは未指定）としてインポートされます。
• 仮想通貨は、部分的に利用可能なステータスで、指定された価格（APIフラグ：is_show_in_store = false、is_enabled = true、is_free = true）なしでインポートされます）。
• 1種類の仮想通貨のみを含むバンドルは、仮想通貨のパッケージとしてインポートされます。
• 複数の種類の仮想通貨を含むバンドルは、個別の仮想通貨パッケージとしてインポートされます。SKUと数量の一意の組み合わせごとに、無料の仮想通貨パッケージが部分的に利用可能なステータスで、指定された価格（APIフラグ：is_show_in_store = false、is_enabled = true、is_free = true）なしでインポートされます。
• さまざまなタイプのアイテムを含むバンドルは、バンドルとしてインポートされます。
• PlayFabでアイテムの説明フィールドが入力されていない場合、名前フィールドがアイテムの説明として使用されます；名前がない場合は、SKUが使用されます。

インポートの制限

インゲームストアの制限

• コンテナおよびコンテナを含むバンドルはインポートされません。
• DropTable および DropTable を含むバンドルはインポートされません。
• isStackable、isTradable、UsageCount、UsagePeriod、UsagePeriodGroupなどのPlayFabに固有のパラメータは無視されます。
• 消耗品は数量を考慮せずに作成されます（アイテムは最初の使用後にインベントリから消えます）。

PlayFabの制限

• PlayFab は実際通貨で価格を保存しません。RM（リアルマネー）としてコード化された事前設定された仮想通貨のみが使用され、これは実際の通貨（100 RM = 1 USD）に相当します。したがって、アイテムの価格は仮想通貨またはRMでのみ設定できます。
• アイテムのSKUは一意であり、数字、ラテン文字、ハイフン、アンダースコアで構成されている必要があります。

入手方法

PlayFabからカタログをインポートする

PlayFabをまだ構成していない場合は、次のようにします：

• PlayFabアカウントを作成します。
• ゲームを作成します。
• ゲームタイトルIDを取得します。
• PlayFabシークレットキーを取得します。

アドミンページに移動し、PlayFabからインゲームストアまでアイテムをインポートしてください。

1. アドミンページであなたのプロジェクトを開き、「ストア > カタログ管理 > 外部プラットフォームとの統合 > PlayFabに移動します。
2. アイテムインポートタブで以下を指定してください：
   • タイトルID — PlayfabでのプロジェクトID。
   • 秘密鍵 — PlayFabのプロジェクトのキー。
3. 保存するをクリックします。
4. ユーザーインベントリをPlayFabと同期させます（任意）：
   1. インベントリ同期に移動して以下を指定してください：
      • タイトルID — PlayfabでのプロジェクトID。
      • 秘密鍵 — PlayFabのプロジェクトのキー。
   2. Set the PlayFabとユーザーインベントリを同期させるトグルをオンにします。
   3. 保存するをクリックします。
5. アイテムインポートタブに移動してインポートを開始するをクリックします。カタログのインポートが自動的に始まります。
6. サイトビルダーで作成したウェブストアで仮想アイテムを販売するには、アドミンページでアイテムグループを構成し、各アイテムに1つまたは複数のグループを割り当てます。
7. アイテム画像を表示するには、アドミンページに画像をアップロードしてください。

インポートが正常に完了したかどうかを確認するには、サイドメニューのストアセクションに移動し、仮想通貨、仮想アイテム、バンドルタブでアイテム、通貨、バンドルが有効になっていることを確認します。

カタログを再インポートする

• すでにストアに登録されているアイテムは更新されます。
• ストアで販売していないアイテムが追加されます。
• インポート元からすでに削除されたアイテムは、ストアに残ります。アドミンページまたはAPI経由で削除することができます。

PlayFabインベントリにアイテムを追加する

• ユーザーのインベントリをPlayFabと同期させることにより。
• PlayFabストレージとエクソーラログインを統合することにより。この場合、トークンに指定されたPlayFab ID。エクソーラ側でアイテムを返却する場合、トークンでPlayFabにリクエストを送信します。

ユーザーインベントリをPlayFabと同期させたい場合：

1. アドミンページであなたのプロジェクトを開き、ストア > カタログ管理 > 外部プラットフォームとの統合 > PlayFabに移動します。
2. イベントリの同期に移動して、以下のことを指定してください：
   • タイトルID — PlayFabで一意のゲームID。
   • 秘密鍵 — PlayFabのプロジェクトのキー。
3. ユーザーインベントリをPlayFabと同期するトグルを「オン」にします。
4. 「保存する」をクリックします。

インゲームストアで購入したアイテムの情報が自動的にPlayFabに転送されるようになりました。