Skip to main content
PlayFab for Unity (v2 统一版) 是基于 PlayFab 统一 SDK 构建的新一代 Unity 集成。它以单个 Unity Package Manager (UPM) 包的形式分发。 此包取代了三个独立的 v1 Unity 包:PlayFab Unity SDK (Services REST 封装)、v1 PlayFab Multiplayer for Unity 插件v1 PlayFab Party for Unity 插件
所有新项目都应使用 PlayFab for Unity (v2 统一版)。你不能在同一项目中同时使用 v1 和 v2。

主要优势

PlayFab for Unity 将统一 SDK 的现代架构带给了 Unity:
  • 单一包:一次 UPM 安装即可获得 PlayFab Core、Services、Multiplayer(大厅和匹配)以及 Party。你不再需要单独的 Services、Multiplayer 和 Party 包。
  • 统一身份验证:当你使用 PFAuthentication 登录时,它会生成一个统一的实体句柄,供 Services 和 Multiplayer 重用。不再需要为每个组件调用 SetEntityToken 或为每次调用跟踪 PlayFabAuthenticationContext
  • 自动令牌管理:后台进程会刷新实体令牌。你不再需要手动重新登录。
  • 一致的异步模型:Services 和 Multiplayer 调用使用统一 SDK 的异步模式,取代了 v1 的 (request, onSuccess, onError) 回调对。
  • 原生 HTTP 和序列化:与跨引擎为统一 SDK 提供支持的相同原生 libHttpClient 处理 HTTP 流量。由 PFHttpConfig 进行配置。不再需要 v1 的可插拔传输 (ITransportPlugin) 和 JSON 序列化器 (ISerializerPlugin)。
  • 感知 GDK 的编辑器工具:你已安装的 Microsoft Gaming Development Kit (GDK) 会自动解析原生二进制文件。可通过 PlayFab → Change GDK 菜单在已安装的 GDK 版本之间切换。

支持的平台

PlayFab for Unity 官方支持:
  • Windows(XBOX 商店及其他 PC 商店)
  • XBOX(One、Series S|X、Cloud)
对其他平台的支持即将推出。

入门

有关设置、安装、前提条件、示例场景和故障排除的信息可在 GitHub 仓库中找到: GitHub 上的 PlayFab Unity SDK

相关资源

最后修改于 2026年8月25日