> ## 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.

# 適用於 Unreal Engine 的 PlayFab OnlineSubsystem 版本資訊

> 適用於 Unreal Engine 4 和 5 之 PlayFab OnlineSubsystem 外掛程式的版本歷程記錄和版本資訊，涵蓋 Party、多人遊戲和大廳的更新。

# PlayFab Unreal Engine OnlineSubsystem 版本資訊

如需下載和安裝指示，請參閱[快速入門：PlayFab Online Subsystem (OSS)](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart)。

## 2.3.8

**2.3.8 版已可搭配 Unreal Engine 5.7 使用。**

UE5.7 升級修正：

* 從大廳搜尋索引鍵對應及相關查詢篩選邏輯中移除了未使用的 `SEARCH_PRESENCE` 索引鍵，簡化了大廳搜尋參數的處理。
* 移除了 Win64 上與工作階段搜尋相關的無效程式碼，因為新的加入邏輯不再依賴此路徑。

錯誤修正：

* 在 `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，使其不再相依於此標頭。

錯誤修正：

* 修正了意外失去連線的玩家可能無法加入或建立另一個工作階段的問題。
* 修正了 `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)](/zh-TW/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，將 `GetAuthSessionTicket()` 取代為 `GetAuthTicketForWebApi()`。

已知問題：

* 在 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)](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds)。
* 不支援 FOnlineSessionSettings 的 `NumPrivateConnections`，因為 PlayFab 服務不會追蹤私人連線。

## 2.3.3

功能更新：

* 新增了對專用伺服器案例的支援。如需為遊戲設定專用伺服器的詳細資訊，請參閱[專用伺服器設定指南](/zh-TW/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 外掛程式整合指南](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration)。
* 引進新的設定布林值 `bForceAutoLogin`。
  * 先前在 Win64 和 PlayStation 平台上，預設行為是一律嘗試為主要本機使用者呼叫 `AutoLogin()`。
  * 如果您想在其他地方呼叫 `Login()`，這個新的設定布林值可讓您在 Win64 和 PlayStation 平台上停用 `AutoLogin()`。
  * 在 `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 版本](/zh-TW/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。如需詳細資訊，請參閱關於 [5.3 WinGDK HTTP running issue with xCurl](https://udn.unrealengine.com/s/question/0D54z00009l9fK0CAI/53-wingdk-http-module-wont-compile-with-xcurl) 的 Unreal Engine 論壇文章。

## 2.3.0

* 支援 UE5.2 和先前的 UE 版本 (UE4.27+、UE5.0 和 UE5.1。請參閱[快速入門：支援哪些 Unreal Engine 版本](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview#which-versions-of-unreal-engine-are-supported))。

功能修正：

* 使用原生平台邀請，為 GDK、Steam 和 PlayStation 實作了 `FOnlineSessionPlayFab::SendSessionInviteToFriends` 和 `FOnlineExternalUIPlayFab::ShowInviteUI`
* 修正了玩家平台識別碼的顯示
* 修正了無法更新成員屬性和大廳搜尋索引鍵的問題
* 修正了在 XBOX 平台上暫停和繼續之後無法玩新遊戲的問題
* 修正了 GDK 上的麥克風音訊問題
* 修正了 `OnlineSessionInterfacePlayFab` 中對 `bIsDedicated` 的修改

編譯修正：

* 針對 Unreal Engine 5.2 淘汰了 XboxOne，並以 XB1 取代
* 解決了所有平台上的建置警告、非 unity 建置錯誤，以及使用者無法存取 Unreal Engine 時的編譯問題

已知問題：

* 若要邀請 Steam 或 PlayStation 玩家，主機必須在相同的平台上。

## 2.0.0

* UE4 引擎 OSS PlayFab 已更新為使用 PlayFab 提供的多人遊戲功能，例如大廳、配對以及 PlayFab Party。
  此更新以 PlayFab 大廳取代 XBOX 提供的 MPSD，並以 Azure 配對服務取代 XBL Smart Match。
* 此版本的 OSS 不再支援 XDK。

## 1.0.7

* UE4 引擎 4.26 版是搭配此版本 OnlineSubsystemPlayfab 使用的建議版本。

### 注意事項：

* 將 OnlineSubsystemPlayFabParty 重新命名為 OnlineSubsystemPlayfab。


## Related topics

- [適用於 Unreal 的 Azure PlayFab Party Online Subsystem](/zh-TW/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [Unreal Engine 快速入門](/zh-TW/services/playfab/sdks/unreal/quickstart.md)
- [PlayFab Online Subsystem (OSS)](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview.md)
- [PlayFab 2017 版本資訊](/zh-TW/services/playfab/release-notes/2017.md)
- [PlayFab for Unreal Engine 概觀](/zh-TW/services/playfab/sdks/unified-unreal/overview.md)