Skip to main content

PlayFab for Unreal Engine (v2 统一版)

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

概述

PlayFab for Unreal Engine 提供统一的集成体验,将所有 PlayFab 组件整合到一个分发版本中。此分发版本包含两个主要组件:
  • PlayFabUnreal:提供身份验证、服务和游戏存档的核心插件。提供经济、排行榜、玩家数据、统计等 PlayFab 功能。
  • OnlineSubsystemPlayFab:Online Subsystem (OSS) 集成,支持 Lobby、Matchmaking、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 的会话接口为多人游戏会话创建和管理游戏大厅
  • Matchmaking:根据技能、偏好和其他标准连接玩家
  • Party 数据通信:面向实时多人游戏的低延迟、跨平台消息传递
  • Party 语音聊天:集成的语音通信,具有 Azure Cognitive Services 提供的语音转文本和翻译等功能
OSS 与 Unreal Engine 现有的网络模式无缝集成,让你能够使用熟悉的 Unreal API,同时利用 PlayFab 可扩展的后端基础设施。 OSS 还支持:
  • 同时进行的多个会话:同时创建、加入和管理多个命名会话,例如在活动比赛旁边有一个社交大厅。每个命名会话可以使用自己的 PlayFab Party 网络。游戏实例仍然只有一个活动的游戏连接,而语音一次由一个会话拥有。
  • 专用服务器托管:使用 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:游戏功能,包括排行榜、经济、玩家数据、统计和目录管理
  • PlayFab Game Saves:跨平台云存档,用于跨设备和会话保存玩家进度

入门

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

相关资源

最后修改于 2026年8月25日