概要
スタンドアロンの PlayFab Services C/C++ SDK (2023 年リリース) では、自動トークン更新、改善されたメモリ管理、強化されたスレッド制御などのモダンな開発プラクティスが導入されました。ただし、PlayFab Party や PlayFab Multiplayer などの他のスタンドアロン SDK はこれらの改善を採用していませんでした。統合 SDK は、これらのコンポーネントを 1 つの統合されモダン化された SDK にまとめます。既存の PlayFab スタンドアロン SDK (v1) は引き続きサポートされていますが、新規プロジェクトには PlayFab 統合 SDK (v2) をお勧めします。
主なメリット
統合 SDK は、スタンドアロン SDK と比較して大幅な改善を提供します:- 簡素化された統合: 単一の SDK インストールおよび更新プロセスにより、複数の SDK ダウンロードとバージョンを管理する必要がなくなります。XBOX/Windows では、SDK は GDK にバンドルされています (2025 年 10 月 GDK、バージョン 2510 から)。
-
統合された認証: 認証は
PFAuthenticationAPI を通じて 1 回実行され、結果として得られるPFEntityHandleはすべてのコンポーネントで使用されます。コンポーネントは内部的に自動的に Core サービスにトークンを問い合わせるため、手動のトークンの受け渡しが不要になり、統合エラーが減少します。 - 自動トークン管理: 一元化されたトークン更新ロジックが、バックグラウンドでエンティティ トークンの更新を自動的に処理し、長時間のゲームプレイ セッション中のセッション有効期限切れを防ぎます。
- 一貫したプログラミング モデル: すべてのコンポーネントは、初期化、API 呼び出し、エラー処理、非同期操作、統合ログの標準化されたパターンに従っており、学習曲線を大幅に削減します。
-
高度なスレッド制御とメモリ管理: すべてのコンポーネントは、
XTaskQueueの統合を通じてカスタム メモリ アロケーターと高度なスレッド制御をサポートしており、リソースの割り当てとスレッドの動作をきめ細かく制御できます。
サポートされているプラットフォームとゲーム エンジン
次の表は、PlayFab 統合 SDK のプラットフォームおよびゲーム エンジンのサポートを示しています。PlayStation® および Nintendo プラットフォーム SDK へのアクセスには、それぞれのプラットフォーム保有者との NDA が必要です。詳細については、SDK とサンプルへのアクセスを申請する を参照してください。
機能の可用性
統合 SDK コンポーネントは一緒に出荷されますが、現在のリリースでは特定のプラットフォーム上で一部の機能が制限されたり暫定的に提供されたりする場合があります。次の表は、このプレビューの機能準備状況をまとめています。
ダッシュ (—) は、その機能が現在そのプラットフォームでサポートされていないことを示します。
この表と観察された動作の間に相違がある場合は、PlayFab サポート チャネルを介して問題を報告し、製品チームがドキュメントを更新してギャップに対処できるようにしてください。
SDK コンポーネント
PlayFab 統合 SDK はモジュラー アーキテクチャを採用しており、プロジェクトに必要なコンポーネントのみを統合できます。XBOX/Windows では、SDK は Microsoft GDK のインストールに含まれています。SDK は次のコンポーネントのヘッダーとバイナリを提供します。- libHttpClient: XBOX と PlayFab SDK で使用されるクロス プラットフォームの HTTP/WebSocket 抽象化。非同期 API、メモリ管理、再試行ロジックを提供します。すべての SDK コンポーネントで必須です。スレッド管理には XTaskQueue との統合がオプションで提供されます。
- PlayFab Core: すべての PlayFab コンポーネントの基礎機能。認証、エンティティ管理、構成、テレメトリ、ログ、エラー処理を担当します。
- PlayFab Services: LiveOps、経済、プログレッションの共有サービス。
- PlayFab Multiplayer: ロビー作成とマッチメイキング サービス。
- PlayFab Party: 低遅延、クロス プラットフォームの音声、テキスト チャット、データ通信。音声からテキスト、テキストから音声、翻訳などのオプションの Azure Cognitive Services 統合が可能。
- PlayFab GameSave: デバイスやセッションを跨いでプレイヤーの進行状況を保持するためのクラウド ベースのゲーム セーブ ストレージと同期。