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

# PlayFab Unified SDK

> PlayFab Unified SDK v2 的概觀，它整合了 Core、Services、Multiplayer、Party 和 GameSave，並提供統一的驗證和權杖重新整理。

PlayFab Unified SDK 是新一代的開發平台，將所有 PlayFab 用戶端程式庫整合成單一、一致的產品。它在所有 PlayFab 元件之間提供一致、簡化的整合體驗，改善互通性並簡化用戶端開發。

## 概觀

獨立的 [PlayFab Services C/C++ SDK](/zh-TW/services/playfab/sdks/c) (於 2023 年發行) 引進了新式開發做法，例如自動權杖重新整理、改進的記憶體管理和增強的執行緒控制。不過，其他獨立 SDK (例如 PlayFab Party 和 PlayFab Multiplayer) 並未採用這些改進。Unified SDK 將這些元件結合成一個一致、現代化的 SDK。

<Note>
  現有的 PlayFab 獨立 SDK (v1) 仍受支援，但建議新專案使用 PlayFab Unified SDK (v2)。
</Note>

## 主要優點

Unified SDK 相較於獨立 SDK 提供了顯著的改進：

* **簡化整合**：單一 SDK 安裝和更新程序，讓您不需要管理多個 SDK 下載和版本。在 XBOX/Windows 上，SDK 會隨附於 GDK 中 (從 2025 年 10 月 GDK 版本 2510 開始)。

* **統一驗證**：透過 `PFAuthentication` API 執行一次驗證，產生的 `PFEntityHandle` 即可在所有元件中使用。元件會在內部自動向 Core 服務查詢權杖，免除手動傳遞權杖的需求，並減少整合錯誤。

* **自動權杖管理**：集中式權杖重新整理邏輯會在背景自動處理實體權杖更新，避免在長時間遊戲工作階段中工作階段到期。

* **一致的程式設計模型**：所有元件都遵循標準化的初始化、API 呼叫、錯誤處理、非同步作業和統一記錄模式，大幅降低學習曲線。

* **進階執行緒控制和記憶體管理**：所有元件都透過 `XTaskQueue` 整合支援自訂記憶體配置器和進階執行緒控制，讓您能精細控制資源配置和執行緒行為。

## 支援的平台和遊戲引擎

下表顯示 PlayFab Unified 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 和範例的存取權](/zh-TW/services/playfab/sdks/request-access-for-sdks-samples)。
</Note>

*"PlayStation" 是 Sony Interactive Entertainment Inc. 的商標。*

## 功能可用性

Unified 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 Unified SDK 採用模組化架構，可讓您只整合專案所需的元件。在 XBOX/Windows 上，SDK 會包含在 Microsoft GDK 安裝中。SDK 提供下列元件的標頭和二進位檔：

* **[libHttpClient](https://github.com/microsoft/libHttpClient)**：XBOX 和 PlayFab SDK 所使用的跨平台 HTTP/WebSocket 抽象層。提供非同步 API、記憶體管理和重試邏輯。所有 SDK 元件都需要它。可選擇性地與 [XTaskQueue](/zh-TW/reference/system/xtaskqueue/xtaskqueue_members) 整合以進行執行緒管理。
* **[PlayFab Core](/zh-TW/services/playfab/sdks/playfab-sdk-intro)**：所有 PlayFab 元件的基礎功能。處理驗證、實體管理、設定、遙測、記錄和錯誤處理。
* **[PlayFab Services](/zh-TW/services/playfab/sdks/playfab-sdk-intro)**：適用於 LiveOps、經濟和進度的共用服務。
* **[PlayFab Multiplayer](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)**：大廳建立和配對服務。
* **[PlayFab Party](/zh-TW/services/playfab/multiplayer/networking/party-sdks/overview)**：低延遲、跨平台的語音、文字聊天和資料通訊，並可選擇性地整合 Azure 認知服務，以提供語音轉文字、文字轉語音、翻譯等功能。
* **[PlayFab GameSave](/zh-TW/services/playfab/player-progression/game-saves/overview)**：雲端遊戲存檔儲存和同步，可跨裝置和工作階段保留玩家進度。

## 開發做法

Unified SDK 將 2023 年 [PlayFab Services C/C++ SDK](/zh-TW/services/playfab/sdks/c) 中引進的新式開發做法延伸至所有元件：

* [非同步作業](/zh-TW/services/playfab/sdks/unified-sdk/async-model)
* [記憶體管理](/zh-TW/services/playfab/sdks/unified-sdk/memory-management)
* [追蹤和診斷](/zh-TW/services/playfab/sdks/unified-sdk/debug-trace)

## 版本控制

PlayFab Unified SDK 遵循[語意化版本控制](https://semver.org/)原則，從 2.0.0 版開始，確保可預測且一致的發行管理。


## Related topics

- [PlayFab for Unity (v2 Unified)](/zh-TW/services/playfab/sdks/unified-unity/overview.md)
- [從 PlayFab 獨立 SDK v1 移轉至 Unified SDK v2](/zh-TW/services/playfab/sdks/unified-sdk/migrating-from-v1.md)
- [PlayFab Unified SDK 快速入門設定](/zh-TW/services/playfab/sdks/unified-sdk/quickstart-setup.md)
- [PlayFab Unified SDK 中的偵錯追蹤](/zh-TW/services/playfab/sdks/unified-sdk/debug-trace.md)
- [PlayFab Unified SDK 中的記憶體管理](/zh-TW/services/playfab/sdks/unified-sdk/memory-management.md)