Skip to main content
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 SDKPlayFab Unity SDK 文档 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 插件版本控制方案

例如,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 上报告任何构建或运行时问题。
最后修改于 2026年8月24日