> ## 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 Multiplayer Unity 外掛程式概觀

> 包裝 Lobby 和 Matchmaking C++ SDK 的 PlayFab Multiplayer Unity 外掛程式概觀，包括支援的 Unity 版本和整合注意事項。

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](https://github.com/PlayFab/UnitySDK) 和 [PlayFab Unity SDK 文件](/zh-TW/services/playfab/sdks/unity3d)。

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 外掛程式版本控制配置

```
X.X.X.Y-(distribution-point-indicator).Z
```

例如，`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 的任何建置或執行階段問題。


## Related topics

- [Party Unity 外掛程式概觀](/zh-TW/services/playfab/multiplayer/networking/party-unity-overview.md)
- [PlayFab Unreal GSDK 外掛程式概觀](/zh-TW/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Multiplayer Unity 外掛程式快速入門](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)
- [Party Unity 外掛程式快速入門](/zh-TW/services/playfab/multiplayer/networking/party-unity-plugin-quickstart.md)
- [PlayFab Party Unity 外掛程式版本資訊](/zh-TW/services/playfab/multiplayer/networking/party-unity-release-notes.md)