> ## 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 插件概览

> PlayFab Multiplayer Unity 插件的概览,该插件对 Lobby 和 Matchmaking C++ SDK 进行了包装,包括所支持的 Unity 版本和集成注意事项。

PlayFab Multiplayer Unity SDK 插件是在原生 PlayFabMultiplayer C++ 库之上封装的 Unity C# 包装器,为 Unity 游戏开发人员的便利而创建。

它使你能够在 Unity 游戏中使用 PlayFab Multiplayer 服务。目前包括 Lobby 和 Matchmaking。它专为在多个平台上开发游戏而设计。

PlayFab Multiplayer Unity 插件与 PlayFab“核心”Unity SDK 协同工作。PlayFab“核心”Unity SDK 提供了其他 PlayFab 功能,例如经济、排行榜等。有关更多信息,请参阅 [PlayFab Unity SDK](https://github.com/PlayFab/UnitySDK) 和 [PlayFab Unity SDK 文档](/services/playfab/sdks/unity3d)。

PlayFab Multiplayer Unity 插件可作为 Unity Asset 包供下载。

## PlayFab Multiplayer Unity 插件提供哪些 API 功能?

* Lobby
* Matchmaking
* 支持以下平台:
  * GDK:
    * XBOX Series X|S
    * XBOX One
    * PC
  * Windows
* 支持在上述平台之间进行跨平台游戏

## PlayFab Multiplayer Unity 插件包含哪些内容?

* 由 `PlayFabMultiplayer` 类提供的、用 Unity C# 编写的顶层 Multiplayer API,以及用于用户 Unity 游戏与 PlayFabMultiplayer 库集成的预制体
* C# 互操作层,提供用于访问底层原生 (C++) Multiplayer 库 API 的托管代码接口。它由顶层 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,可以按任何顺序将以下所有版本的 PlayFab Multiplayer Unity 插件导入到你的 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

- [PlayFab Unreal GSDK 插件概览](/zh-CN/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [PlayFab Multiplayer Unity 版入门](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-sdk-getting-started.md)
- [Multiplayer Unity 插件快速入门](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.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)