> ## 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 製品

> PlayFab v1 スタンドアロン SDK と v2 統合 SDK 製品ラインを比較し、新規または既存のゲーム プロジェクトに適したクライアント ライブラリを選択します。

**PlayFab 統合 SDK (v2)** は、PlayFab SDK の次世代版です。すべての PlayFab クライアント ライブラリを 1 つの統合された製品に集約します。統合された認証、自動トークン管理、およびすべてのコンポーネントにわたる一貫した API を備えた、モダンで合理化された開発エクスペリエンスを提供します。統合 SDK は現在進行中の開発の主要なフォーカスであり、すべての新機能、プラットフォーム サポート、および改善は v2 を最優先で対象としています。

**新規プロジェクト** の場合、現在サポートされているプラットフォームが要件を満たしている場合は **PlayFab 統合 SDK (v2)** をお勧めします。v1 スタンドアロン SDK を使用している **既存のプロジェクト** は、統合アーキテクチャの利点を活かすために [v2 に移行](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/migrating-from-v1.md) できます。

**v1 スタンドアロン SDK** は現在もサポートされており、v2 でまだサポートされていないプラットフォームが必要なプロジェクト向けに、より広範なプラットフォーム カバレッジを提供します。

> [!NOTE]
>
> v1 と v2 の SDK を同じプロジェクト内で併用することはできません。v2 でまだサポートされていないプラットフォームが必要な場合は、すべてのコンポーネントに v1 を使用してください。

## PlayFab 統合 SDK (v2)

[PlayFab 統合 SDK](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/overview.md) は、v1 の個別 SDK パッケージのコレクションを、PlayFab の全機能をカバーする単一の統合された製品に置き換えます。複数の SDK を個別にダウンロード、インストール、更新する代わりに、必要なすべてが含まれた 1 つの SDK で作業します。

### 含まれる内容

統合 SDK は、次のコンポーネントを 1 つのインストール パッケージにバンドルします。

| コンポーネント | 説明 |
| - | - |
| **PlayFab Core** | 認証、エンティティ管理、テレメトリ、ログ |
| **PlayFab Services** | LiveOps、経済、プログレッション、データ分析 |
| **PlayFab GameSave** | クラウド保存ストレージと同期 |
| **PlayFab Multiplayer** | ロビーの作成、マッチメイキング、セッション管理 |
| **PlayFab Party** | Azure AI Services 統合によるリアルタイム ネットワーキング、ボイス チャット、テキスト通信 |

### 主なメリット

* **単一の SDK**: すべての PlayFab 機能に対して 1 つのインストールおよび更新プロセスで済み、Services、Party、Multiplayer 用の個別パッケージを管理する必要がなくなります
* **統合された認証**: 一度認証するだけで、すべてのコンポーネントで動作する単一の `PFEntityHandle` を受け取ります。エンティティ トークンをサービス間で手動で取得したり渡したりする必要はもうありません
* **自動トークン管理**: バックグラウンドでのトークン更新により、エンティティ トークンの更新が自動的に処理され、回避策コードなしで長時間のゲームプレイ中にセッションの有効期限切れを防ぎます
* **一貫したプログラミング モデル**: すべてのコンポーネントは、初期化、API 呼び出し、エラー処理、非同期操作の標準化されたパターンに従います。1 つのパターンを学習すれば、どこでも使用できます
* **カスタム メモリ管理**: `PFMemoryHooks` を通じて独自のメモリ アロケーターをプラグインすることで、リソース制約のある環境や高性能環境できめ細かい制御が可能になります
* **高度なスレッド制御**: `XTaskQueue` の統合により、柔軟なディスパッチ モード (Manual、ThreadPool、SerializedThreadPool、Immediate) が提供されるため、非同期処理をどこでどのように実行するかを正確に制御できます
* **組み込みのデバッグ トレース**: 単一のデバッグ出力からすべてのコンポーネントにわたる API リクエスト、応答、エラーを監視するための拡張可能なトレース システム
* **将来性のある設計**: すべての新しい PlayFab 機能、プラットフォーム拡張、パフォーマンス改善は、v2 のみを対象としています

> [!TIP]
>
> すでに v1 を使用していますか? ステップ バイ ステップのガイドについては [v1 から v2 への移行](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/migrating-from-v1.md) を参照してください。移行は通常、手動のトークン管理を削除し、コンポーネント間の初期化ロジックを統合することで、コードベースを簡素化します。

### 開発者エクスペリエンスの比較

以下の例は、v2 が v1 と比較して一般的なタスクをどのように簡素化するかを示しています。

| タスク | v1 (スタンドアロン SDK) | v2 (統合 SDK) |
| - | - | - |
| **セットアップ** | 各 SDK を個別にダウンロードして構成 | すべてのコンポーネントを含む 1 つの SDK をインストール |
| **認証** | エンティティ トークンを手動で取得し、サービス間で渡して、有効期限前に更新 | ログインを 1 回呼び出し、`PFEntityHandle` を受け取り、任意のコンポーネントに渡す |
| **トークン更新** | セッションの有効期限切れを回避するためのカスタム更新ロジックを記述 | バックグラウンドで自動的に処理 |
| **エラー処理** | SDK ごとに異なるエラー パターン | すべてのコンポーネントで一貫したエラー報告 |

## PlayFab スタンドアロン SDK (v1)

[v1 スタンドアロン SDK](https://docs.xbox.com/ja-jp/services/playfab/sdks/sdk-overview.md) は、さまざまな PlayFab 機能に対する個別の SDK パッケージで構成されています。引き続き完全にサポートされていますが、複数の SDK インストールの管理と、コンポーネント間の手動調整が必要です。v1 SDK は引き続き重要な修正を受けますが、新機能とプラットフォーム サポートは v2 専用に開発されています。

### SDK コンポーネント (v1)

* [**PlayFab Services SDK**](https://docs.xbox.com/ja-jp/services/playfab/sdks/playfab-sdk-intro.md): LiveOps、経済、マッチメイキング、データ分析
* [**PlayFab Party SDK**](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/party-sdks/overview.md): ネットワーキングと音声/テキスト チャット通信
* [**PlayFab Lobby and Matchmaking SDK**](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks.md): ロビーとマッチメイキング機能

## サポートされているプラットフォーム

次の表は、v2 統合 SDK と v1 スタンドアロン SDK のプラットフォーム サポートを比較しています。

| プラットフォーム | v2 (統合 SDK) | v1 (スタンドアロン SDK) |
| - | :-: | :-: |
| Windows (PC およびハンドヘルド) | ✅ サポート済み | ✅ サポート済み |
| XBOX (One、Series S/X、Cloud) | ✅ サポート済み | ✅ サポート済み |
| Steam Deck | ✅ サポート済み | ❌ 現在サポートされていません |
| PlayStation 4 ¹ | ✅ サポート済み | ✅ サポート済み |
| PlayStation 5 ¹ | ✅ サポート済み | ✅ サポート済み |
| Nintendo Switch ¹ | ✅ サポート済み | ✅ サポート済み |
| Nintendo Switch 2 ¹ | ✅ サポート済み | ✅ サポート済み |
| Linux | ❌ 現在サポートされていません | ✅ サポート済み |
| iOS | ❌ 現在サポートされていません | ✅ サポート済み |
| Android | ❌ 現在サポートされていません | ✅ サポート済み |
| macOS | ❌ 現在サポートされていません | ✅ サポート済み |

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

## 関連項目

* [PlayFab 統合 SDK (v2)](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/overview.md)
* [スタンドアロン SDK の概要 (v1)](https://docs.xbox.com/ja-jp/services/playfab/sdks/sdk-overview.md)
* [SDK とサンプルへのアクセスを申請する](https://docs.xbox.com/ja-jp/services/playfab/sdks/request-access-for-sdks-samples.md)


## Related topics

- [PlayFab 統合 SDK](https://docs.xbox.com/ja-jp/services/playfab/sdks/unified-sdk/overview.md)
- [PlayFab Services SDK リリース ノート 2026](https://docs.xbox.com/ja-jp/services/playfab/release-notes/index.md)
- [PlayFab Services C/C++ SDK リリース ノート](https://docs.xbox.com/ja-jp/services/playfab/release-notes/playfab-c/index.md)
- [PlayFab Services SDK リリースノート 2023](https://docs.xbox.com/ja-jp/services/playfab/release-notes/2023.md)
- [PlayFab Services SDK リリースノート 2024](https://docs.xbox.com/ja-jp/services/playfab/release-notes/2024.md)