跳轉到主要內容
PlayFab Unified SDK (v2) 是新一代的 PlayFab SDK。它將所有 PlayFab 用戶端程式庫整合成單一、一致的產品。它提供新式、簡化的開發體驗,具備統一的驗證、自動權杖管理,以及所有元件之間一致的 API。Unified SDK 是持續開發的主要重點,所有新功能、平台支援和改進都會優先以 v2 為目標。 對於新專案,如果目前支援的平台符合您的需求,建議您使用 PlayFab Unified SDK (v2)。使用 v1 獨立 SDK 的現有專案可以移轉至 v2,以利用統一的架構。 v1 獨立 SDK 目前仍受支援,並為需要 v2 尚未支援之平台的專案提供更廣泛的平台涵蓋範圍。
v1 和 v2 SDK 不能在同一個專案中一起使用。如果您需要 v2 尚未支援的平台,請對所有元件使用 v1。

PlayFab Unified SDK (v2)

PlayFab Unified SDK 以涵蓋所有 PlayFab 功能的單一、一致產品,取代個別 v1 SDK 套件的集合。您不需要個別下載、安裝和更新多個 SDK,只需使用一個包含您所需一切的 SDK。

包含的內容

Unified SDK 會將下列元件組合成單一安裝:

主要優點

  • 單一 SDK:所有 PlayFab 功能只需一個安裝和更新程序,不需要再為 Services、Party 和 Multiplayer 管理個別套件
  • 統一驗證:只需驗證一次,即可取得適用於所有元件的單一 PFEntityHandle。不需要再於服務之間手動擷取和傳遞實體權杖
  • 自動權杖管理:背景權杖重新整理會自動處理實體權杖更新,避免在長時間遊戲過程中工作階段到期,而不需要任何因應措施程式碼
  • 一致的程式設計模型:所有元件都遵循標準化的初始化、API 呼叫、錯誤處理和非同步作業模式,只需學習一種模式,即可到處使用
  • 自訂記憶體管理:透過 PFMemoryHooks 插入您自己的記憶體配置器,以在資源受限或高效能的環境中進行精細控制
  • 進階執行緒控制:XTaskQueue 整合提供彈性的分派模式 (Manual、ThreadPool、SerializedThreadPool、Immediate),讓您可以精確控制非同步工作的執行方式和位置
  • 內建偵錯追蹤:可延伸的追蹤系統,可從單一偵錯輸出監視所有元件的 API 要求、回應和錯誤
  • 面向未來:所有新的 PlayFab 功能、平台擴充和效能改進都只以 v2 為目標
已經在使用 v1?如需逐步指南,請參閱從 v1 移轉至 v2。移轉通常可以移除手動權杖管理,並統一各元件的初始化邏輯,從而簡化您的程式碼基底。

開發人員體驗比較

下列範例說明與 v1 相比,v2 如何簡化常見工作:

PlayFab 獨立 SDK (v1)

v1 獨立 SDK 由適用於不同 PlayFab 功能的個別 SDK 套件組成。雖然它們仍受到完整支援,但需要管理多個 SDK 安裝,並在元件之間進行手動協調。v1 SDK 會繼續收到重大修正,但新功能和平台支援只會針對 v2 開發。

SDK 元件 (v1)

支援的平台

下表比較 v2 Unified SDK 與 v1 獨立 SDK 之間的平台支援:
存取 PlayStation® 和 Nintendo 平台 SDK 需要與各平台持有者簽署 NDA。如需詳細資料,請參閱要求 SDK 和範例的存取權。

另請參閱

最後修改於 2026年10月8日