> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab for Unreal Engine 概述

> 开始使用 PlayFab for Unreal Engine (v2 统一版),这是涵盖身份验证、服务、Lobby、Matchmaking 和 Party 的插件包。

# PlayFab for Unreal Engine (v2 统一版)

PlayFab for Unreal Engine (v2 统一版) 是基于 [PlayFab 统一 SDK](/services/playfab/sdks/unified-sdk/overview) 构建的新一代集成。它为 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 仓库](https://github.com/PlayFab/PlayFabSDK_Unreal) 以获取最新的平台可用性更新。

<Info>
  我们推荐所有新项目使用 PlayFab for Unreal Engine (v2 统一版)。它提供现代化的统一架构和改进的开发者体验。
</Info>

如果你的项目需要 v2 尚不支持的平台,请改用 [v1 PlayFab Unreal 插件](/services/playfab/sdks/unreal) 和 [v1 OnlineSubsystem PlayFab](/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview),因为 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 插件](https://github.com/PlayFab/PlayFabSDK_Unreal)**

该仓库包括:

* 安装和配置指南
* API 参考文档
* 示例项目和代码示例
* 特定于平台的设置说明

## 相关资源

* [PlayFab 统一 SDK 概述](/services/playfab/sdks/unified-sdk/overview)
* [v1 PlayFab Unreal 插件](/services/playfab/sdks/unreal)
* [v1 OnlineSubsystem PlayFab](/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview)
* [PlayFab Game Saves](/services/playfab/player-progression/game-saves/overview)
* [PlayFab Party](/services/playfab/multiplayer/networking/party-sdks/overview)
* [PlayFab Multiplayer](/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)


## Related topics

- [适用于 Unreal 的 Azure PlayFab Party Online Subsystem](/zh-CN/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [Unreal Engine 快速入门](/zh-CN/services/playfab/sdks/unreal/quickstart.md)
- [在 Unreal Engine 中使用 GDK](/zh-CN/build/gdk-and-engines/unreal/unreal.md)
- [集成 PlayFab Unreal Engine Marketplace 插件](/zh-CN/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)
- [PlayFab OnlineSubsystem for Unreal Engine 发行说明](/zh-CN/services/playfab/multiplayer/networking/unreal-release-notes.md)