概觀
獨立的 PlayFab Services C/C++ SDK (於 2023 年發行) 引進了新式開發做法，例如自動權杖重新整理、改進的記憶體管理和增強的執行緒控制。不過，其他獨立 SDK (例如 PlayFab Party 和 PlayFab Multiplayer) 並未採用這些改進。Unified SDK 將這些元件結合成一個一致、現代化的 SDK。現有的 PlayFab 獨立 SDK (v1) 仍受支援，但建議新專案使用 PlayFab Unified SDK (v2)。
主要優點
Unified SDK 相較於獨立 SDK 提供了顯著的改進：- 簡化整合：單一 SDK 安裝和更新程序，讓您不需要管理多個 SDK 下載和版本。在 XBOX/Windows 上，SDK 會隨附於 GDK 中 (從 2025 年 10 月 GDK 版本 2510 開始)。
-
統一驗證：透過
PFAuthenticationAPI 執行一次驗證，產生的PFEntityHandle即可在所有元件中使用。元件會在內部自動向 Core 服務查詢權杖，免除手動傳遞權杖的需求，並減少整合錯誤。 - 自動權杖管理：集中式權杖重新整理邏輯會在背景自動處理實體權杖更新，避免在長時間遊戲工作階段中工作階段到期。
- 一致的程式設計模型：所有元件都遵循標準化的初始化、API 呼叫、錯誤處理、非同步作業和統一記錄模式，大幅降低學習曲線。
-
進階執行緒控制和記憶體管理：所有元件都透過
XTaskQueue整合支援自訂記憶體配置器和進階執行緒控制，讓您能精細控制資源配置和執行緒行為。
支援的平台和遊戲引擎
下表顯示 PlayFab Unified SDK 的平台和遊戲引擎支援：存取 PlayStation® 和 Nintendo 平台 SDK 需要與各平台持有者簽署 NDA。如需詳細資料，請參閱要求 SDK 和範例的存取權。
功能可用性
Unified SDK 元件會一起出貨，但在目前版本中，某些功能在特定平台上的可用性可能有限或屬於暫時性。下表摘要說明此預覽版的功能就緒狀態。
破折號 (—) 表示該平台目前不支援此功能。
如果您發現此表格與觀察到的行為不一致，請透過您的 PlayFab 支援管道提出問題，讓產品團隊可以更新文件並解決落差。
SDK 元件
PlayFab Unified 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 認知服務，以提供語音轉文字、文字轉語音、翻譯等功能。
- PlayFab GameSave：雲端遊戲存檔儲存和同步，可跨裝置和工作階段保留玩家進度。