跳转到主要内容
PlayFab for Unreal Engine (v2 统一版) 是基于 PlayFab 统一 SDK 构建的新一代集成。它为 Unreal Engine 游戏开发人员提供与 PlayFab 后端服务的全面集成,将统一 SDK 的现代开发实践和统一架构带入 Unreal Engine 生态系统。

概述

PlayFab for Unreal Engine 提供统一的集成体验,将所有 PlayFab 组件整合到一个分发版本中。此分发版本包含两个主要组件:
  • PlayFabUnreal:提供身份验证、服务和游戏存档的核心插件。提供 Economy、排行榜、玩家数据、统计数据等 PlayFab 功能。
  • OnlineSubsystemPlayFab:Online Subsystem (OSS) 集成,支持 Lobby、匹配、Party 网络以及 VOIP (Voice over Internet Protocol)。包括跨平台游戏、跨平台通信以及由 Azure Cognitive Services 提供支持的辅助功能,如实时文本聊天翻译和语音转录。

支持的平台

PlayFab for Unreal Engine 已准备好在以下平台上为你的游戏提供支持:
  • Windows(PC 和掌机)
  • XBOX(One、Series S|X、Cloud)
  • Steam Deck
  • PlayStation(PS4、PS5)
  • Nintendo Switch(Switch 1、Switch 2)
对更多平台的支持正在开发中。查看 GitHub 仓库 以获取最新的平台可用性更新。
我们推荐所有新项目使用 PlayFab for Unreal Engine (v2 统一版)。它提供现代化的统一架构和改进的开发者体验。
如果你的项目需要 v2 尚不支持的平台,请改用 v1 PlayFab Unreal 插件 和 v1 OnlineSubsystem PlayFab,因为 v1 和 v2 不能在同一项目中同时使用。

组件

OnlineSubsystemPlayFab (OSS)

OnlineSubsystem PlayFab (OSS) 提供与 Unreal Engine 的 Online Subsystem 框架的完整集成,通过标准 Unreal 接口启用 PlayFab 的多人游戏和网络服务。此组件包括:
  • Lobby:使用 Unreal 的会话接口为多人游戏会话创建和管理游戏大厅
  • 匹配:根据技能、偏好和其他标准连接玩家
  • Party 数据通信:面向实时多人游戏的低延迟、跨平台消息传递
  • Party 语音聊天:集成的语音通信,具有 Azure Cognitive Services 提供的语音转文本和翻译等功能
OSS 与 Unreal Engine 现有的网络模式无缝集成,让你能够使用熟悉的 Unreal API,同时利用 PlayFab 可扩展的后端基础设施。 OSS 还支持:
  • 同时进行的多个会话:同时创建、加入和管理多个命名会话,例如在活动比赛旁边有一个社交大厅。每个命名会话可以使用自己的 PlayFab Party 网络。游戏实例仍然只有一个活动的游戏连接,而语音一次由一个会话拥有。
  • 组匹配:已在同一 PlayFab 大厅中的玩家可以作为一个组查找比赛。
  • 邀请加入任意会话:使用 GDK 时,玩家可以邀请好友加入 GameSession 以外的命名会话,并且 PlayFab 大厅邀请现在会到达 Unreal 的标准邀请回调。
  • 专用服务器托管:使用 PlayFab 服务器实体托管会话,以便专用服务器可以创建并拥有 PlayFab 大厅并管理 Party 网络,而无需已登录的原生平台用户。
  • 可配置的可搜索会话设置:选择哪些 Unreal 会话设置可通过 PlayFab Lobby 搜索,以便根据特定标题的属性(如游戏模式、播放列表、技能等级或地图)启用服务器端筛选发现。
  • Play-in-Editor (PIE):在 Unreal Engine 5.8 或更高版本上,将 GDK 作为原生 OSS,在单个 Play-in-Editor 实例中运行 OSS,以便无需打包或独立构建即可测试支持的流程。

PlayFabUnreal 插件

PlayFabUnreal 插件提供核心 PlayFab 功能:
  • PlayFab Core:身份验证和事件管道(遥测)服务,构成所有 PlayFab 操作的基础
  • PlayFab Services:游戏功能,包括排行榜、Economy、玩家数据、统计数据和目录管理
  • PlayFab Game Saves:跨平台云存档,用于跨设备和会话保存玩家进度

入门

有关设置说明和详细文档,请访问 GitHub 仓库: GitHub 上的 PlayFab Unreal Engine 插件 该仓库包括:
  • 安装和配置指南
  • API 参考文档
  • 示例项目和代码示例
  • 特定于平台的设置说明
最后修改于 2026年11月6日