> ## 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.

# Party Unity 外掛程式概觀

> PlayFab Party Unity 外掛程式概觀，此外掛程式可為各支援平台上的 Unity 遊戲加入即時語音聊天和低延遲資料訊息功能。

PlayFab Party Unity SDK 外掛程式是建置在原生 Party C++ 程式庫之上的 Unity C# 包裝函式，旨在方便 Unity 遊戲開發人員使用。

它可讓您在 Unity 遊戲中使用 Party 和 Party Cognitive Services，包括：

* 多人遊戲網路
* 聊天訊息和資料交換
* 跨平台交談和跨平台遊玩
* 協助工具功能，例如即時文字聊天翻譯和語音轉譯

它是為在多個平台上開發遊戲而設計的。

PlayFab Party Unity 外掛程式可與 PlayFab「核心」Unity SDK 外掛程式搭配使用，後者提供其他 PlayFab 功能，例如經濟系統、排行榜等。如需詳細資訊，請參閱 [PlayFab Unity SDK](https://github.com/PlayFab/UnitySDK) 和 [PlayFab Unity SDK 文件](/zh-TW/services/playfab/sdks/unity3d)。

Party Unity 外掛程式以 Unity 資產套件的形式提供下載。目前支援在下列平台上開發遊戲：

* Microsoft Game Core (GDK)\*、Windows、iOS、Android：[https://github.com/playfab/PlayFabPartyUnity](https://github.com/playfab/PlayFabPartyUnity) (公開存取)
* Sony PlayStation®：
  * PS4™：[https://dev.azure.com/PlayFabPrivate/PS4/\_git/PlayFabPartyUnityPS4](https://dev.azure.com/PlayFabPrivate/PS4/_git/PlayFabPartyUnityPS4) (受限存取，需向 Microsoft 代表提出要求)
  * PS5™：[https://dev.azure.com/PlayFabPrivate/PS5/\_git/PlayFabPartyUnityPS5](https://dev.azure.com/PlayFabPrivate/PS5/_git/PlayFabPartyUnityPS5) (受限存取，需向 Microsoft 代表提出要求)
* Nintendo Switch™：[https://dev.azure.com/PlayFabPrivate/Switch/\_git/PlayFabPartyUnitySwitch](https://dev.azure.com/PlayFabPrivate/Switch/_git/PlayFabPartyUnitySwitch) (受限存取，需向 Microsoft 代表提出要求)

「PlayStation」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

「PS4」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

「PS5」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

\*- 外掛程式中不包含 GDK 的基礎 Party 程式庫。如需詳細資料，請參閱版本控制一節。

「PlayStation」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

## Party Unity 外掛程式提供哪些 API 功能？

* 遊戲網路
* VoIP
* 支援下列平台：
  * GDK：
    * XBOX Series X|S
    * XBOX One
    * PC
  * Windows
  * iOS
  * Android
  * PS4™
  * PS5™
  * Switch
* 支援上述平台之間的跨平台遊玩和跨平台交談
* Party Cognitive Services
  * 即時文字聊天翻譯
  * 即時語音聊天轉譯
  * 即時語音聊天翻譯
  * 文字轉語音合成

「PS4」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

「PS5」是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

## Party Unity 外掛程式包含哪些內容？

* 以 Unity C# 撰寫的簡化最上層 Party API，由 `PlayFabMultiplayerManager` 類別和預製物件提供，讓使用者的 Unity 遊戲更容易與 Party 程式庫的核心功能整合
* C# Interop 層，為基礎原生 (C++) Party 程式庫 API 提供 Managed 程式碼介面。最上層 C# API 會使用此層。
* 每個支援平台的基礎原生 (C++) Party 二進位檔：
  * Windows 的 Party DLL 程式庫
  * iOS 的 Party iOS Framework 程式庫 (裝置和模擬器)
  * Android 的 Party AAR 程式庫封存
  * **不**包含 Microsoft Game Core 的 Party DLL 程式庫。這些程式庫隨 GDK 一起散發，必須在建置 Unity 專案之前複製到外掛程式中 (請參閱外掛程式隨附之 README 檔案中的詳細資料)
  * PS4、PS5 的 Party 動態程式庫
  * Switch 的 Party 靜態程式庫
* PlayFab「核心」Unity SDK 外掛程式 (必要時可獨立更新)
* XBOX Live 驗證和原則提供者 API，目前僅在 GDK 平台上支援

## Party Unity 外掛程式版本與平台之間的相容性

Party Unity 外掛程式會依平台發佈於數個散發點 (Git 存放庫) 供下載。部分散發點的存取受到限制，需要向您的 Microsoft 代表提出要求。

Party Unity 外掛程式使用自訂的版本控制配置，以釐清從不同散發點下載之版本之間的相容性，並參考基礎原生程式庫的特定版本。

### Party Unity 外掛程式版本控制配置

```text theme={null}
X.X.X.Y-(distribution-point-indicator).Z
```

例如，`1.5.0.3-main.0` (從主要公開 GitHub 存放庫下載的版本) 或 `1.5.0.3-ps5.0` (僅包含 PS5 Party 二進位檔的版本，從受限存取的存放庫下載)。

版本元件：

* `X.X.X` - 所有支援平台中基礎 Party 程式庫的最低版本。此值提供與基礎 C++ 程式庫版本的參考一致性。在上述範例中，每個平台所包含的 Party 程式庫都是 `1.5.0` 版或更新版本。
* `Y` - 針對任何指定的 X.X.X 版本部分，Party Unity C# 層中任何修改的遞增索引。
* `(distribution-point-indicator)` - 用於追蹤特定 Party Unity 外掛程式套件是從哪個散發點下載的助憶代碼。它因散發點而異，例如 `main` (主要公開散發 GitHub 存放庫)、`ps5` (供 PS5 開發人員使用的受限存取 Microsoft Azure DevOps 存放庫) 等。
* `Z` - 散發點特有之任何修改的遞增索引 (例如，僅針對特定平台更新或修補的 Party 二進位檔)。

任何版本元件中的數字越大，表示版本越新，重要性由左至右遞減。

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

無論散發點為何，如果**版本的前四個數字 (`X.X.X.Y`) 相同**，Party Unity 外掛程式保證與來自任何其他散發點的 Party Unity 外掛程式完全相容。您可以依任何順序將相容的版本匯入 Unity 專案，而不會彼此覆寫或破壞，因為它們共用的程式碼完全相同。每個版本可能有額外且不重疊的平台專屬檔案。

例如，如果您的目標是 iOS、PS5 和 Switch，您可以依任何順序將下列所有版本的 Party Unity 外掛程式匯入 Unity 專案：

* `1.5.0.3-main.0` (匯入 iOS 的 Party 二進位檔及其他檔案)
* `1.5.0.3-ps5.0` (匯入 PS5 的 Party 二進位檔及其他檔案)
* `1.5.0.3-sw.0` (匯入 Switch 的 Party 二進位檔及其他檔案)

這些外掛程式中所包含的共用 (跨平台) Unity C# 程式碼都相同。

## 支援哪些 Unity 版本？

我們支援從 Unity 2017 開始的所有近期 Unity 版本。不過，您的選擇可能會受到各平台 Unity 開發附加元件可用性的限制。如需詳細資料，請參閱對應的 Unity 文件。這接著也可能會限制您對平台 SDK 的選擇。一般而言，我們會使用各平台可用的最新 Unity 開發附加元件版本之一來測試 Party Unity 外掛程式。我們鼓勵客戶回報任何新版 Unity Editor、Unity 附加元件或平台 SDK 的任何建置或執行階段問題。

## 定價

**符合資格的 XBOX 生態系統開發人員可以透過 [Foundation 模式](/zh-TW/services/playfab/get-started/mode-overview)免費使用 Party 網路和語音聊天。**

Party Cognitive Services 和其他服務可能會有相關費用。如需詳細資料，請參閱 [PlayFab Party 的計費](/zh-TW/services/playfab/pricing/meters/meters#party)或連絡您的 Microsoft 代表。


## Related topics

- [PlayFab Multiplayer Unity 外掛程式概觀](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
- [PlayFab Unreal GSDK 外掛程式概觀](/zh-TW/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.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)
- [Multiplayer Unity 外掛程式快速入門](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)