跳轉到主要內容
PlayFab Multiplayer Unity SDK 外掛程式是建置在原生 PlayFabMultiplayer C++ 程式庫之上的 Unity C# 包裝函式,是為了方便 Unity 遊戲開發人員而建立的。 它可讓您在 Unity 遊戲中使用 PlayFab Multiplayer 服務。目前,這包括大廳和配對。它是為在多個平台上開發遊戲而設計的。 PlayFab Multiplayer Unity 外掛程式可與 PlayFab「核心」Unity SDK 搭配運作。PlayFab「核心」Unity SDK 提供其他 PlayFab 功能,例如經濟、排行榜等。如需詳細資訊,請參閱 PlayFab Unity SDK 和 PlayFab Unity SDK 文件。 PlayFab Multiplayer Unity 外掛程式以 Unity Asset 套件的形式提供下載。

PlayFab Multiplayer Unity 外掛程式提供哪些 API 功能?

  • 大廳
  • 配對
  • 支援下列平台:
    • GDK:
      • XBOX Series X|S
      • XBOX One
      • PC
    • Windows
  • 支援上述平台之間的跨平台遊戲

PlayFab Multiplayer Unity 外掛程式包含哪些內容?

  • 以 Unity C# 撰寫、由 PlayFabMultiplayer 類別提供的頂層 Multiplayer API,以及用於將使用者的 Unity 遊戲與 PlayFabMultiplayer 程式庫整合的預製物件
  • C# Interop 層,為基礎原生 (C++) Multiplayer 程式庫 API 提供 Managed 程式碼介面。頂層 C# API 會使用它。
  • 每個支援平台的基礎原生 (C++) PlayFabMultiplayer 二進位檔:
    • 適用於 GDK 的 Multiplayer DLL 程式庫
    • 適用於 Windows 的 Multiplayer DLL 程式庫
  • PlayFab「核心」Unity SDK 外掛程式 (必要時可獨立更新)

PlayFab Multiplayer Unity 外掛程式版本和平台之間的相容性

PlayFab Multiplayer Unity 外掛程式將依平台在數個散發點 (Git 存放庫) 發佈並提供下載。部分散發點的存取受到限制。您需要向您的 Microsoft 代表傳送要求,且可能需要額外的步驟。 為了針對從不同散發點下載之版本間的相容性提供更好的指引,並反映對基礎原生程式庫特定版本的參考,PlayFab Multiplayer Unity 外掛程式遵循自訂的版本控制配置。

PlayFab Multiplayer Unity 外掛程式版本控制配置

例如,1.2.0.3-gdk.0 (從存取受限的 GDK 存放庫下載的版本) 或 1.2.0.3-ps5.0 (只包含 PlayStation®5 Multiplayer 二進位檔的版本,從存取受限的 PS5™ 存放庫下載)。 版本元件:
  • X.X.X - 所有支援平台中基礎 PlayFabMultiplayer 程式庫的最低版本。這用於與基礎 C++ 程式庫版本保持一般參考一致性。在上述範例中,每個平台所包含之 PlayFabMultiplayer 程式庫的版本為 1.2.0 或更高版本。
  • Y - 針對版本的任何指定 X.X.X 部分,Multiplayer Unity C# 層中任何修改的遞增索引。
  • (distribution-point-indicator) - 一個助記代碼,用於追蹤特定 PlayFab Multiplayer Unity 外掛程式套件是從哪個散發點下載的。它因散發點而異,例如 gdk (為 GDK 開發人員提供、存取受限的 Microsoft Azure DevOps 存放庫)、ps5 (為 PS5 開發人員提供、存取受限的 Microsoft Azure DevOps 存放庫) 等。
  • Z - 散發點特有之任何修改的遞增索引 (例如,僅針對特定平台更新/修補的 Multiplayer 二進位檔)。
任何版本元件中的數字越高表示版本越新,重要性由左至右排列。 “PlayStation” 是 Sony Interactive Entertainment Inc. 的註冊商標或商標。 “PS5” 是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

來自不同散發點之版本間的相容性

無論 PlayFab Multiplayer Unity 外掛程式是從哪個散發點下載的,只要其版本的前四個數字 (X.X.X.Y) 相同,就保證與從任何其他散發點下載的 PlayFab Multiplayer Unity 外掛程式完全相容。來自不同散發點的相容版本可以任何順序匯入使用者的 Unity 專案中,而沒有相互覆寫/破壞的風險,因為它們的共用程式碼應該是相同的。不過,它們每一個都可能有一些特定平台專屬的其他 (非共用) 檔案,這些檔案不應重疊。 例如,如果您以 GDK、PS5 和 Switch 為目標,您可以按任何順序在 Unity 專案中匯入下列所有版本的 PlayFab Multiplayer Unity 外掛程式:
  • 1.2.0.3-gdk.0 (匯入 GDK 的 Multiplayer 二進位檔及其他檔案)
  • 1.2.0.3-ps5.0 (匯入 PS5 的 Multiplayer 二進位檔及其他檔案)
  • 1.2.0.3-sw.0 (匯入 Switch 的 Multiplayer 二進位檔及其他檔案)
這些外掛程式中所包含的共用 (跨平台) Unity C# 程式碼都會相同。

支援哪些 Unity 版本?

我們致力於支援從 Unity 2017 開始的所有最新 Unity 版本,但您的選擇可能會受到各特定平台之 Unity 開發附加元件可用性的限制,請參閱對應的 Unity 文件。這反過來也可能限制您對平台 SDK 的選擇。 一般而言,我們會使用各平台可用之最新 Unity 開發附加元件版本之一來測試 PlayFab Multiplayer Unity 外掛程式。我們鼓勵您回報任何新版 Unity 編輯器、Unity 附加元件或平台 SDK 的任何建置或執行階段問題。
最後修改於 2026年10月8日