> ## 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)](/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart)를 참조하세요.

## 2.3.8

**릴리스 2.3.8은 Unreal Engine 5.7에서 사용할 준비가 되었습니다.**

UE5.7 업그레이드 수정 사항:

* 로비 검색 키 매핑 및 관련 쿼리 필터 로직에서 사용되지 않는 `SEARCH_PRESENCE` 키를 제거하여 로비 검색 매개변수 처리를 단순화했습니다.
* 새로운 참가 로직이 더 이상 이 경로에 의존하지 않으므로 Win64에서의 세션 검색 관련 데드 코드를 제거했습니다.

버그 수정:

* 기본(native) 세션 참가에 실패했을 때 PlayFab 및 Party 세션의 적절한 정리, 로컬 세션 참조 제거 및 델리게이트 알림을 보장하기 위해 `FOnlineSessionPlayFab`에 새로운 `CleanupFailedJoinSession` 메서드를 추가했습니다. 이 메서드는 이제 모든 관련 실패 경로에서 호출됩니다.

* 참가할 때마다 검색하는 대신 원하는 세션(`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`이 `WhitelistPlatforms` 대신 `PlatformAllowList`를 사용하도록 업데이트하고 `OnlineSubsystemSwitch`의 이름을 `OnlineSubsystemNintendo`로 변경했습니다. 또한 플러그인 버전을 증가시켰습니다.
* UE 5.6 이상에서는 `DriverClassName` 매개변수에 "/Script/" 접두사가 필요합니다. 예를 들어 `"OnlineSubsystemPlayFab.PlayFabNetDriver"` 대신 `"/Script/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)](/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds)를 참조하세요.
* PlayFab 서비스가 프라이빗 연결을 추적하지 않으므로 FOnlineSessionSettings의 `NumPrivateConnections`는 지원되지 않습니다.

## 2.3.4

* UE5.4 릴리스를 지원했습니다.

다음 라이브러리를 업데이트했습니다:

* Windows 및 GDK 모두에 대해 Multiplayer SDK C++ 라이브러리를 버전 1.7.2로 업데이트했습니다.
* Windows 및 GDK 모두에 대해 Party SDK C++ 라이브러리를 버전 1.9.5로 업데이트했습니다.

기능 수정:

* 플레이어 이름에 이모지나 특수 문자가 포함된 경우 세션 생성 또는 참가에 실패하는 문제를 수정했습니다.
* 로비 액세스 정책 업데이트 실패 문제를 수정했습니다.
* `GetBytes()` 및 `GetSize()`로 인해 발생할 수 있는 잠재적 크래시를 수정했습니다.
* 기본 OSS에 대한 누락된 통과(pass-through) 함수 및 인터페이스를 추가했습니다.
* \[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)](/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds)를 참조하세요.
* PlayFab 서비스가 프라이빗 연결을 추적하지 않으므로 FOnlineSessionSettings의 `NumPrivateConnections`는 지원되지 않습니다.

## 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()`을 호출하려고 시도하는 것이었습니다.
  * 이 새로운 구성 부울값을 사용하면 `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 버전](/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` 명령줄 인수를 사용하여 게임을 실행하여 xCurl 대신 WinHTTP로 전환하세요. 자세한 내용은 [xCurl과 관련된 5.3 WinGDK HTTP 실행 문제](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 버전](/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로 대체했습니다.
* 빌드 경고, 논-유니티(non-unity) 빌드 오류, 사용자가 모든 플랫폼에서 Unreal Engine에 액세스할 수 없는 경우의 컴파일 문제를 해결했습니다.

알려진 문제:

* Steam 또는 PlayStation 플레이어를 초대하려면 호스트가 동일한 플랫폼에 있어야 합니다.

## 2.0.0

* UE4 엔진 OSS PlayFab이 Lobby, Matchmaking과 같은 PlayFab에서 제공하는 멀티플레이어 기능과 PlayFab Party를 함께 사용하도록 업데이트되었습니다.
  이 업데이트는 XBOX에서 제공하는 MPSD를 PlayFab Lobby로, XBL Smart match를 Azure Matchmaking 서비스로 대체합니다.
* 이 버전의 OSS는 XDK를 더 이상 지원하지 않습니다.

## 1.0.7

* 이 버전의 OnlineSubsystemPlayfab과 함께 사용할 것을 권장하는 UE4 엔진 버전은 4.26입니다.

### 참고:

* OnlineSubsystemPlayFabParty를 OnlineSubsystemPlayfab으로 이름을 변경했습니다.


## Related topics

- [Integrate the PlayFab Unreal Engine Marketplace plugin](/ko/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)
- [PlayFab for Unreal Engine 개요](/ko/services/playfab/sdks/unified-unreal/overview.md)
- [PlayFab Online Subsystem (OSS)](/ko/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview.md)
- [PlayFab 릴리스 노트 2018](/ko/services/playfab/release-notes/2018.md)
- [PlayFab Online Subsystem (OSS) Quickstart](/ko/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart.md)