> ## 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 OnlineSubsystem for Unreal Engine 发行说明

> 适用于 Unreal Engine 4 和 5 的 PlayFab OnlineSubsystem 插件的版本历史记录和发行说明,涵盖 Party、多人游戏和大厅更新。

# PlayFab Unreal Engine OnlineSubsystem 发行说明

有关下载和安装说明,请参阅 [快速入门:PlayFab Online Subsystem (OSS)](/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart)。

## 2.3.8

**版本 2.3.8 可与 Unreal Engine 5.7 配合使用。**

UE5.7 升级修复:

* 从大厅搜索键映射和相关查询筛选逻辑中删除了未使用的 `SEARCH_PRESENCE` 键,简化了大厅搜索参数的处理。
* 删除了 Win64 上与会话搜索相关的失效代码,因为新的加入逻辑不再依赖此路径。

Bug 修复:

* 向 `FOnlineSessionPlayFab` 添加了新的 `CleanupFailedJoinSession` 方法,以确保在原生会话加入失败时正确清理 PlayFab 和 Party 会话,删除本地会话引用,以及委托通知。此方法现在会在所有相关的失败路径中调用。

* 更改了逻辑,缓存所需的会话 (`CachedDesiredSession`),而不是在每次加入时进行搜索,简化并提高了原生会话加入的可靠性。

## 2.3.7

**版本 2.3.7 可与 Unreal Engine 5.6 配合使用。**

库更新:

* Multiplayer SDK C++ 库 (Windows/GDK):从 1.7.9 更新到 1.8.0。
* Party SDK C++ 库 (Windows/GDK):从 1.10.5 更新到 1.10.12。

UE5.6 升级修复:

* 更新了 `OnlineSubsystemPlayFab.uplugin`,使用 `PlatformAllowList` 代替 `WhitelistPlatforms`,并将 `OnlineSubsystemSwitch` 重命名为 `OnlineSubsystemNintendo` 以保持一致性。同时增加了插件版本。
* 在 UE 5.6 及更高版本上,`DriverClassName` 参数需要 "/Script/" 前缀。例如,使用 `"/Script/OnlineSubsystemPlayFab.PlayFabNetDriver"` 而不是 `"OnlineSubsystemPlayFab.PlayFabNetDriver"`。
  使用示例:
  ```
  [/Script/Engine.GameEngine]
  +NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="/Script/OnlineSubsystemPlayFab.PlayFabNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")
  ```

## 2.3.6

**版本 2.3.6 可与 Unreal Engine 5.5 配合使用。**

库更新:

* Multiplayer SDK C++ 库 (Windows/GDK):从 1.7.2 更新到 1.7.9。
* Party SDK C++ 库 (Windows/GDK):从 1.9.5 更新到 1.10.5。

UE5.5 升级修复:

* `OnSessionParticipantsChanged`(在 UE5.2 中[已弃用](https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5.2-release-notes?application_version=5.2#onlinesubsystem-2))在 UE5.5 中被移除。更新了 PF OSS 以使用新的 `OnSessionParticipantJoined` 和 `OnSessionParticipantLeft`。
* `GDKUserManager.h` 已从 `Engine\Platforms\GDK\Source\Runtime\GDKRuntime\Public\GDKUserManager.h` 移动到 `Engine\Platforms\GDK\Source\Runtime\GDKRuntime\Private\GDKUserManager.h`。更新了 PF OSS,使其不再依赖此头文件。

Bug 修复:

* 修复了玩家意外失去连接可能无法加入或创建其他会话的问题。
* 修复了 `FindSessionById` 和 `CreateSession` 可能被乱序调用的问题。

已知问题:

* 在 UE5.5 GDK 中使用 PlayFab Online Subsystem 时,可能会遇到以下运行时错误:`Runtime dependency Party.dll is configured to be staged from C:\Program Files (x86)\Microsoft GDK\<version>\Party.dll and \Engine\Plugins\Online\OnlineSubsystemPlayFab\Platforms\GDK\Redist\Party.dll`。
  若要解决此问题,请参阅 [快速入门:PlayFab Online Subsystem (OSS)](/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds)。
* 不支持 FOnlineSessionSettings 的 `NumPrivateConnections`,因为 PlayFab 服务不跟踪专用连接。

## 2.3.4

* 支持 UE5.4 的发布。

更新了以下库:

* 对 Windows 和 GDK 均将 Multiplayer SDK C++ 库更新到版本 1.7.2。
* 对 Windows 和 GDK 均将 Party SDK C++ 库更新到版本 1.9.5。

功能修复:

* 修复了当玩家名称包含表情符号或特殊类型字符时创建或加入会话失败的问题。
* 修复了无法更新大厅访问策略的问题。
* 修复了 `GetBytes()` 和 `GetSize()` 可能导致的崩溃。
* 添加了原生 OSS 缺少的传递函数和接口。
* \[Steam] 修复了在未先启动 Steam 应用程序的情况下启动 Steam 游戏时的崩溃问题。
* \[Steam] 针对 Steam 1.57 SDK,使用 `GetAuthTicketForWebApi()` 替换了 `GetAuthSessionTicket()`。

已知问题:

* 在 UE5.4 GDK 中使用 PlayFab Online Subsystem 时,可能会遇到以下运行时错误:`Runtime dependency Party.dll is configured to be staged from C:\Program Files (x86)\Microsoft GDK\<version>\Party.dll and \Engine\Plugins\Online\OnlineSubsystemPlayFab\Platforms\GDK\Redist\Party.dll`。
  若要解决此问题,请参阅 [快速入门:PlayFab Online Subsystem (OSS)](/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds)。
* 不支持 FOnlineSessionSettings 的 `NumPrivateConnections`,因为 PlayFab 服务不跟踪专用连接。

## 2.3.3

功能更新:

* 增加了对专用服务器场景的支持。有关为游戏设置专用服务器的更多信息,请参阅 [专用服务器设置指南](/services/playfab/multiplayer/networking/party-unreal-engine-oss-dedicated-servers)。
* 增强了与 [PlayFab SDK Unreal Engine (UE) Marketplace 插件](https://www.unrealengine.com/marketplace/product/playfab-sdk) 的集成。有关集成 PlayFab 插件的更多信息,请参阅 [PlayFab SDK UE Marketplace 插件集成指南](/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration)。
* 引入了新的配置布尔值 `bForceAutoLogin`。
  * 之前,在 Win64 和 PlayStation 平台上,默认行为始终是尝试为主本地用户调用 `AutoLogin()`。
  * 此新配置布尔值允许在 Win64 和 PlayStation 平台上禁用 `AutoLogin()`,如果你希望在其他位置调用 `Login()`。
  * 当 `bForceAutoLogin` 设置为 `true` 时,默认行为保持不变。可以在 `<Windows|PS4|PS5>Engine.ini` 文件的 `OnlineSubsystemPlayFab` 部分下配置 `bForceAutoLogin`。
    ```ini theme={null}
    [OnlineSubsystemPlayFab]
    bForceAutoLogin=<true|false>
    ```
  * 所有其他平台的登录行为保持不变。

## 2.3.2

更新了以下库:

* 对 Windows 和 GDK 均将 Multiplayer SDK C++ 库更新到版本 1.6.5。
* 对 Windows 和 GDK 均将 Party SDK C++ 库更新到版本 1.8.9。

## 2.3.1

* 支持 UE5.3 和以前的 UE 版本(UE4.27+、UE5.0、UE5.1 和 UE5.2。请参阅 [快速入门:支持哪些版本的 Unreal Engine](/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview#which-versions-of-unreal-engine-are-supported))。

已知问题:

* 已知 UE5.3 的 WinGDK 版本存在与 HTTP 请求相关的问题。Epic Games 已识别此问题,并在 5.4 版本中解决了它。若要在 UE5.3 中解决此问题,请使用 `-UseWinHttpGDK` 命令行参数启动游戏,以切换到 WinHTTP 而不是 xCurl。有关详细信息,请参阅 Unreal Engine 论坛关于 [5.3 WinGDK HTTP 使用 xCurl 运行问题](https://udn.unrealengine.com/s/question/0D54z00009l9fK0CAI/53-wingdk-http-module-wont-compile-with-xcurl) 的帖子。

## 2.3.0

* 支持 UE5.2 和以前的 UE 版本(UE4.27+、UE5.0 和 UE5.1。请参阅 [快速入门:支持哪些版本的 Unreal Engine](/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview#which-versions-of-unreal-engine-are-supported))。

功能修复:

* 通过原生平台邀请为 GDK、Steam 和 PlayStation 实现了 `FOnlineSessionPlayFab::SendSessionInviteToFriends` 和 `FOnlineExternalUIPlayFab::ShowInviteUI`
* 修复了玩家平台 ID 的显示
* 修复了无法更新成员属性和大厅搜索键的问题
* 修复了在 XBOX 平台上暂停和恢复后无法开始新游戏的问题
* 修复了 GDK 上的麦克风音频问题
* 修复了 `OnlineSessionInterfacePlayFab` 中对 `bIsDedicated` 的修改问题

编译修复:

* 在 Unreal Engine 5.2 中弃用了 XboxOne 并用 XB1 替换
* 解决了在所有平台上用户无法访问 Unreal Engine 时的生成警告、非 Unity 生成错误和编译问题

已知问题:

* 要邀请 Steam 或 PlayStation 玩家,主机必须在同一平台上。

## 2.0.0

* UE4 引擎 OSS PlayFab 已更新,可使用 PlayFab 提供的多人游戏功能(例如大厅和匹配)以及 PlayFab Party。
  此更新用 PlayFab Lobby 和 Azure Matchmaking 服务替换了 XBOX 提供的 MPSD 和 XBL Smart match。
* 此版本的 OSS 不再支持 XDK。

## 1.0.7

* UE4 Engine 4.26 版本是与此版本 OnlineSubsystemPlayfab 一起使用的推荐版本。

### 说明:

* 将 OnlineSubsystemPlayFabParty 重命名为 OnlineSubsystemPlayfab。


## Related topics

- [PlayFab Multiplayer C++ SDK 发行说明](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [适用于 Unreal 的 Azure PlayFab Party Online Subsystem](/zh-CN/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [PlayFab Services SDK 2026 发行说明](/zh-CN/services/playfab/release-notes/index.md)
- [PlayFab Services C/C++ SDK 发行说明](/zh-CN/services/playfab/release-notes/playfab-c/index.md)
- [集成 PlayFab Unreal Engine Marketplace 插件](/zh-CN/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)