PlayFab Multiplayer Unity 插件概述

项目
07/12/2023

PlayFab Multiplayer Unity SDK 插件是在为方便 Unity 游戏开发人员而创建的本机 PlayFabMultiplayer C++ 库之上的 Unity C# 包装器。。

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

PlayFab Multiplayer Unity 插件与 PlayFab "core" Unity SDK 一起工作。 PlayFab "core" Unity SDK 提供其他 PlayFab 功能，如经济、排行榜等。有关详细信息，请参阅PlayFab Unity SDK和 PlayFab Unity SDK 文档。

PlayFab Multiplayer Unity 插件可作为 Unity 资产包下载。

PlayFab Multiplayer Unity 插件提供了哪些 API 功能？

大厅
匹配
支持以下平台：
- GDK：
  - Xbox 系列 X\|S
  - Xbox One
  - 电脑
- Windows
支持上述平台的交叉游戏

PlayFab Multiplayer Unity 插件中包含哪些内容？

由 PlayFabMultiplayer 类和预制件提供且在 Unity C# 中编写的顶级 Multiplayer API，以便将用户的 Unity 游戏与 PlayFabMultiplayer 库集成
向基础本机 (C++) Multiplayer 库 API 提供托管代码接口的 C# 互操作层。它由顶级 API 使用 C#。
每个受支持平台的基础本机 (C++) PlayFabMultiplayer 二进制文件：
- 适用于 GDK 的 Multiplayer DLL 库
- 适用于 Windows 的 Multiplayer DLL 库
PlayFab"core"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 - Multiplayer Unity C# 层中任何修改的增量索引，适用于版本的任何给定 X.X.X 部分。
(distribution-point-indicator) - 用于跟踪从哪个分发点下载特定 PlayFab Multiplayer Unity 插件程序包的助记码。它因分发点而异，例如，gdk（对 GDK 开发人员，具有受限访问权限的 Microsoft Azure DevOps 存储库）、ps5（对 PS5 开发人员，具有受限访问权限的 Microsoft Azure DevOps 存储库）等。
Z - 分发点唯一的任何修改的增量索引（例如，仅针对特定平台更新/修补的 Multiplayer 二进制文件）。

在任何版本组件中，数字越大，就从左到右而言，表示较新的版本。

“PlayStation”是索尼互动娱乐公司的注册商标或商标。

“PS5”是索尼交互娱乐公司的注册商标或商标。

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

无论从哪个分发点下载 PlayFab Multiplayer Unity 插件，它都保证与从任何其他分发点下载的 PlayFab Multiplayer Unity 插件完全兼容，如果其版本的前四个数字 (X.X.X.Y) 是相同的。可以按任何顺序将不同分发点中的兼容版本导入到用户的 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 的任何构建或运行时问题。

通过