> ## 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 文档](/services/playfab/sdks/unity3d)。

Party Unity 插件可作为 Unity Asset 包下载。目前支持在以下平台上开发游戏:

* 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` 类和 prefab 提供,便于用户将 Unity 游戏与 Party 库的核心功能集成
* C# 互操作层,为底层原生 (C++) Party 库 API 提供托管代码接口。它由顶层 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`(受限访问的 Microsoft Azure DevOps 存储库,面向 PS5 开发者)等。
* `Z` - 特定于该分发点的任何修改的递增索引(例如,仅针对特定平台更新或修补的 Party 二进制文件)。

版本组件中任何数字越大都表示更新的版本,按从左到右的重要性排序。

### 来自不同分发点的版本之间的兼容性

无论分发点如何,只要**其版本的前四个数字 (`X.X.X.Y`) 相同**,一个 Party Unity 插件就能保证与来自任何其他分发点的 Party Unity 插件完全兼容。你可以按任意顺序将兼容版本导入 Unity 项目,而不会相互覆盖或破坏,因为它们的共享代码是相同的。每个版本可能有额外的、不会重叠的平台特定文件。

例如,如果你的目标平台是 iOS、PS5 和 Switch,你可以按任意顺序在你的 Unity 项目中导入以下所有版本的 Party 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 编辑器、Unity 插件或平台 SDK 时遇到的任何构建或运行时问题。

## 定价

**对于符合条件的 XBOX 生态系统开发者,Party 网络和语音聊天通过[基础模式](/services/playfab/get-started/mode-overview)免费提供。**

Party Cognitive Services 和其他服务可能会产生费用。有关详情,请参阅 [PlayFab Party 计费](/services/playfab/pricing/meters/meters#party)或联系你的 Microsoft 代表。


## Related topics

- [PlayFab Multiplayer Unity 插件概览](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
- [PlayFab Unreal GSDK 插件概览](/zh-CN/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Party Unity 插件快速入门](/zh-CN/services/playfab/multiplayer/networking/party-unity-plugin-quickstart.md)
- [PlayFab Party Unity 插件发行说明](/zh-CN/services/playfab/multiplayer/networking/party-unity-release-notes.md)
- [PlayFab Multiplayer Unity 版入门](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-sdk-getting-started.md)