v1 と v2 の SDK を同じプロジェクト内で併用することはできません。v2 でまだサポートされていないプラットフォームが必要な場合は、すべてのコンポーネントに v1 を使用してください。
PlayFab 統合 SDK (v2)
PlayFab 統合 SDK は、v1 の個別 SDK パッケージのコレクションを、PlayFab の全機能をカバーする単一の統合された製品に置き換えます。複数の SDK を個別にダウンロード、インストール、更新する代わりに、必要なすべてが含まれた 1 つの SDK で作業します。含まれる内容
統合 SDK は、次のコンポーネントを 1 つのインストール パッケージにバンドルします。主なメリット
- 単一の SDK: すべての PlayFab 機能に対して 1 つのインストールおよび更新プロセスで済み、Services、Party、Multiplayer 用の個別パッケージを管理する必要がなくなります
- 統合された認証: 一度認証するだけで、すべてのコンポーネントで動作する単一の
PFEntityHandleを受け取ります。エンティティ トークンをサービス間で手動で取得したり渡したりする必要はもうありません - 自動トークン管理: バックグラウンドでのトークン更新により、エンティティ トークンの更新が自動的に処理され、回避策コードなしで長時間のゲームプレイ中にセッションの有効期限切れを防ぎます
- 一貫したプログラミング モデル: すべてのコンポーネントは、初期化、API 呼び出し、エラー処理、非同期操作の標準化されたパターンに従います。1 つのパターンを学習すれば、どこでも使用できます
- カスタム メモリ管理:
PFMemoryHooksを通じて独自のメモリ アロケーターをプラグインすることで、リソース制約のある環境や高性能環境できめ細かい制御が可能になります - 高度なスレッド制御:
XTaskQueueの統合により、柔軟なディスパッチ モード (Manual、ThreadPool、SerializedThreadPool、Immediate) が提供されるため、非同期処理をどこでどのように実行するかを正確に制御できます - 組み込みのデバッグ トレース: 単一のデバッグ出力からすべてのコンポーネントにわたる API リクエスト、応答、エラーを監視するための拡張可能なトレース システム
- 将来性のある設計: すべての新しい PlayFab 機能、プラットフォーム拡張、パフォーマンス改善は、v2 のみを対象としています
開発者エクスペリエンスの比較
以下の例は、v2 が v1 と比較して一般的なタスクをどのように簡素化するかを示しています。PlayFab スタンドアロン SDK (v1)
v1 スタンドアロン SDK は、さまざまな PlayFab 機能に対する個別の SDK パッケージで構成されています。引き続き完全にサポートされていますが、複数の SDK インストールの管理と、コンポーネント間の手動調整が必要です。v1 SDK は引き続き重要な修正を受けますが、新機能とプラットフォーム サポートは v2 専用に開発されています。SDK コンポーネント (v1)
- PlayFab Services SDK: LiveOps、経済、マッチメイキング、データ分析
- PlayFab Party SDK: ネットワーキングと音声/テキスト チャット通信
- PlayFab Lobby and Matchmaking SDK: ロビーとマッチメイキング機能
サポートされているプラットフォーム
次の表は、v2 統合 SDK と v1 スタンドアロン SDK のプラットフォーム サポートを比較しています。PlayStation® および Nintendo プラットフォーム SDK へのアクセスには、それぞれのプラットフォーム保有者との NDA が必要です。詳細については、SDK とサンプルへのアクセスを申請する を参照してください。