> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab 統合 SDK

> 統合された認証とトークン更新機能により Core、Services、Multiplayer、Party、GameSave を集約する PlayFab 統合 SDK v2 の概要。

PlayFab 統合 SDK は、すべての PlayFab クライアント ライブラリを 1 つの統合された製品に集約する次世代の開発プラットフォームです。すべての PlayFab コンポーネントにわたって一貫した合理的な統合エクスペリエンスを提供し、相互運用性を向上させ、クライアント開発を簡素化します。

## 概要

スタンドアロンの [PlayFab Services C/C++ SDK](https://docs.xbox.com/ja-jp/services/playfab/sdks/c.md) (2023 年リリース) では、自動トークン更新、改善されたメモリ管理、強化されたスレッド制御などのモダンな開発プラクティスが導入されました。ただし、PlayFab Party や PlayFab Multiplayer などの他のスタンドアロン SDK はこれらの改善を採用していませんでした。統合 SDK は、これらのコンポーネントを 1 つの統合されモダン化された SDK にまとめます。

> [!NOTE]
>
> 既存の PlayFab スタンドアロン SDK (v1) は引き続きサポートされていますが、新規プロジェクトには PlayFab 統合 SDK (v2) をお勧めします。

## 主なメリット

統合 SDK は、スタンドアロン SDK と比較して大幅な改善を提供します:

* **簡素化された統合**: 単一の SDK インストールおよび更新プロセスにより、複数の SDK ダウンロードとバージョンを管理する必要がなくなります。XBOX/Windows では、SDK は GDK にバンドルされています (2025 年 10 月 GDK、バージョン 2510 から)。

* **統合された認証**: 認証は `PFAuthentication` API を通じて 1 回実行され、結果として得られる `PFEntityHandle` はすべてのコンポーネントで使用されます。コンポーネントは内部的に自動的に Core サービスにトークンを問い合わせるため、手動のトークンの受け渡しが不要になり、統合エラーが減少します。

* **自動トークン管理**: 一元化されたトークン更新ロジックが、バックグラウンドでエンティティ トークンの更新を自動的に処理し、長時間のゲームプレイ セッション中のセッション有効期限切れを防ぎます。

* **一貫したプログラミング モデル**: すべてのコンポーネントは、初期化、API 呼び出し、エラー処理、非同期操作、統合ログの標準化されたパターンに従っており、学習曲線を大幅に削減します。

* **高度なスレッド制御とメモリ管理**: すべてのコンポーネントは、`XTaskQueue` の統合を通じてカスタム メモリ アロケーターと高度なスレッド制御をサポートしており、リソースの割り当てとスレッドの動作をきめ細かく制御できます。

## サポートされているプラットフォームとゲーム エンジン

次の表は、PlayFab 統合 SDK のプラットフォームおよびゲーム エンジンのサポートを示しています。

| プラットフォーム | C/C++ SDK | C/C++ NuGet | Unreal Engine | Unity |
| - | - | - | - | - |
| **Windows (PC およびハンドヘルド)** | GDK 2510+ | — | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **XBOX (One、Series S/X、Cloud)** | GDK 2510+ | — | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **Steam Deck** | GDK 2510+ | — | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unreal) | [GitHub](https://github.com/PlayFab/PlayFabSDK_Unity) |
| **PlayStation®5** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS5/_artifacts/feed/PS5GeneralV2) | ¹ | ¹ |
| **PlayStation®4** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/PS4/_artifacts/feed/PS4GeneralV2) | ¹ | ¹ |
| **Nintendo Switch 2** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch2/_artifacts/feed/Switch2GeneralV2) | ¹ | ¹ |
| **Nintendo Switch** ¹ | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch) | [Azure DevOps](https://dev.azure.com/PlayFabPrivate/Switch/_artifacts/feed/SwitchGeneralV2) | ¹ | ¹ |

> [!NOTE]
>
> PlayStation® および Nintendo プラットフォーム SDK へのアクセスには、それぞれのプラットフォーム保有者との NDA が必要です。詳細については、[SDK とサンプルへのアクセスを申請する](https://docs.xbox.com/ja-jp/services/playfab/sdks/request-access-for-sdks-samples.md) を参照してください。

*「PlayStation」は Sony Interactive Entertainment Inc. の商標です。*

## 機能の可用性

統合 SDK コンポーネントは一緒に出荷されますが、現在のリリースでは特定のプラットフォーム上で一部の機能が制限されたり暫定的に提供されたりする場合があります。次の表は、このプレビューの機能準備状況をまとめています。

| プラットフォーム | Core | Services | GameSave | Multiplayer (Lobby / Matchmaking) | Party Data | Party Voice |
| - | - | - | - | - | - | - |
| **Windows (PC およびハンドヘルド)** | サポート済み | サポート済み | サポート済み | サポート済み | サポート済み | サポート済み |
| **XBOX (One、Series S/X、Cloud)** | サポート済み | サポート済み | サポート済み | サポート済み | サポート済み | サポート済み |
| **Steam Deck** | サポート済み | サポート済み | サポート済み | サポート済み | サポート済み | サポート済み |
| **PlayStation®5** | サポート済み | サポート済み | サポート済み (プレビュー) | サポート済み | サポート済み | サポート済み |
| **PlayStation®4** | サポート済み | サポート済み | — | サポート済み | サポート済み | サポート済み |
| **Nintendo Switch 2** | サポート済み | サポート済み | — | サポート済み | サポート済み | サポート済み |
| **Nintendo Switch** | サポート済み | サポート済み | — | サポート済み | サポート済み | サポート済み |

ダッシュ (—) は、その機能が現在そのプラットフォームでサポートされていないことを示します。

この表と観察された動作の間に相違がある場合は、PlayFab サポート チャネルを介して問題を報告し、製品チームがドキュメントを更新してギャップに対処できるようにしてください。

## SDK コンポーネント

PlayFab 統合 SDK はモジュラー アーキテクチャを採用しており、プロジェクトに必要なコンポーネントのみを統合できます。XBOX/Windows では、SDK は Microsoft GDK のインストールに含まれています。SDK は次のコンポーネントのヘッダーとバイナリを提供します。

* **[libHttpClient](https://github.com/microsoft/libHttpClient)**: XBOX と PlayFab SDK で使用されるクロス プラットフォームの HTTP/WebSocket 抽象化。非同期 API、メモリ管理、再試行ロジックを提供します。すべての SDK コンポーネントで必須です。スレッド管理には [XTaskQueue](https://docs.xbox.com/ja-jp/reference/system/xtaskqueue/xtaskqueue_members.md) との統合がオプションで提供されます。
* **[PlayFab Core](https://docs.xbox.com/ja-jp/services/playfab/sdks/playfab-sdk-intro.md)**: すべての PlayFab コンポーネントの基礎機能。認証、エンティティ管理、構成、テレメトリ、ログ、エラー処理を担当します。
* **[PlayFab Services](https://docs.xbox.com/ja-jp/services/playfab/sdks/playfab-sdk-intro.md)**: LiveOps、経済、プログレッションの共有サービス。
* **[PlayFab Multiplayer](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks.md)**: ロビー作成とマッチメイキング サービス。
* **[PlayFab Party](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/party-sdks/overview.md)**: 低遅延、クロス プラットフォームの音声、テキスト チャット、データ通信。音声テキスト変換、テキスト読み上げ、翻訳などのオプションの Azure Cognitive Services 統合が可能。
* **[PlayFab GameSave](https://docs.xbox.com/ja-jp/services/playfab/player-progression/game-saves/overview.md)**: デバイスやセッションを跨いでプレイヤーの進行状況を保持するためのクラウド ベースのゲーム セーブ ストレージと同期。

## 開発プラクティス

統合 SDK は、2023 年の [PlayFab Services C/C++ SDK](https://docs.xbox.com/ja-jp/services/playfab/sdks/c.md) で導入されたモダンな開発プラクティスを、すべてのコンポーネントに拡張します。

* [非同期操作](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/async-model.md)
* [メモリ管理](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/memory-management.md)
* [トレースと診断](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/debug-trace.md)

## バージョニング

PlayFab 統合 SDK は [セマンティック バージョニング](https://semver.org/) の原則に従い、バージョン 2.0.0 から始まり、予測可能で一貫したリリース管理を保証します。


## Related topics

- [PlayFab 統合 SDK でのメモリ管理](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/memory-management.md)
- [PlayFab SDK 製品](https://docs.xbox.com/ja-jp/services/playfab/sdks/sdk-products.md)
- [PlayFab 統合 SDK での非同期呼び出し](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/async-model.md)
- [PlayFab 統合 SDK でのデバッグ トレース](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/debug-trace.md)
- [移行ガイド: PlayFab スタンドアロン SDK (v1) から PlayFab 統合 SDK (v2) へ](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/migrating-from-v1.md)