> ## 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 개요

> 인증, Services, 로비, 매치메이킹, Party를 포괄하는 플러그인 번들인 PlayFab for Unreal Engine (v2 Unified)로 시작하기.

# PlayFab for Unreal Engine (v2 Unified)

PlayFab for Unreal Engine (v2 Unified)는 [PlayFab 통합 SDK](/services/playfab/sdks/unified-sdk/overview)를 기반으로 구축된 차세대 통합입니다. Unreal Engine 게임 개발자에게 PlayFab의 백엔드 서비스와의 포괄적인 통합을 제공하며, 통합 SDK의 최신 개발 관행 및 통합 아키텍처를 Unreal Engine 생태계에 제공합니다.

## 개요

PlayFab for Unreal Engine은 모든 PlayFab 구성 요소를 단일 배포로 통합하여 통합된 통합 경험을 제공합니다. 이 배포에는 두 가지 주요 구성 요소가 포함됩니다:

* **PlayFabUnreal**: 인증, Services 및 게임 저장을 제공하는 핵심 플러그인. 이코노미, 리더보드, 플레이어 데이터, 통계 등과 같은 PlayFab 기능을 제공합니다.
* **OnlineSubsystemPlayFab**: 로비, 매치메이킹, Party 네트워킹 및 VOIP(Voice over Internet Protocol)를 활성화하는 Online Subsystem (OSS) 통합. 실시간 텍스트 채팅 번역 및 음성 전사와 같은 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 Unified) 사용을 권장합니다. 개선된 개발자 경험을 제공하는 최신 통합 아키텍처를 제공합니다.
</Info>

v2에서 아직 지원되지 않는 플랫폼이 필요한 프로젝트인 경우, v1과 v2를 동일한 프로젝트에서 함께 사용할 수 없으므로, [v1 PlayFab Unreal 플러그인](/services/playfab/sdks/unreal) 및 [v1 OnlineSubsystem PlayFab](/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview)을 대신 사용하세요.

## 구성 요소

### OnlineSubsystemPlayFab (OSS)

OnlineSubsystem PlayFab (OSS)은 Unreal Engine의 Online Subsystem 프레임워크와의 완전한 통합을 제공하여, 표준 Unreal 인터페이스를 통해 PlayFab의 멀티플레이어 및 네트워킹 서비스를 활성화합니다. 이 구성 요소에는 다음이 포함됩니다:

* **로비**: Unreal의 세션 인터페이스를 사용하여 멀티플레이어 세션을 위한 게임 로비 생성 및 관리
* **매치메이킹**: 실력, 선호도 및 기타 기준에 따라 플레이어 연결
* **Party 데이터 통신**: 실시간 멀티플레이어 게임플레이를 위한 낮은 지연 시간의 크로스 플랫폼 메시징
* **Party 음성 채팅**: 음성-텍스트 및 번역과 같은 Azure Cognitive Services 기능이 통합된 음성 통신

OSS는 Unreal Engine의 기존 네트워킹 패턴과 원활하게 통합되어, PlayFab의 확장 가능한 백엔드 인프라를 활용하면서 익숙한 Unreal API를 사용할 수 있게 합니다.

OSS는 또한 다음을 지원합니다:

* **여러 동시 세션**: 활성 매치와 함께 소셜 로비와 같이, 여러 명명된 세션을 동시에 생성, 참여 및 관리합니다. 각 명명된 세션은 자체 PlayFab Party 네트워크를 사용할 수 있습니다. 게임 인스턴스는 여전히 단일 활성 게임플레이 연결을 갖고 있으며, 음성은 한 번에 하나의 세션이 소유합니다.
* **전용 서버 호스팅**: PlayFab 서버 엔티티를 사용하여 세션을 호스팅하므로, 전용 서버가 로그인한 네이티브 플랫폼 사용자 없이 PlayFab 로비를 생성 및 소유하고 Party 네트워킹을 관리할 수 있습니다.
* **구성 가능한 검색 가능한 세션 설정**: 게임 모드, 플레이리스트, 실력 등급 또는 지도와 같은 타이틀별 속성에 대해 서버 측 필터링된 발견을 활성화하기 위해, PlayFab 로비를 통해 검색할 수 있는 Unreal 세션 설정을 선택합니다.
* **PIE (Play-in-Editor)**: 네이티브 OSS로 GDK와 함께 Unreal Engine 5.8 이상에서 단일 Play-in-Editor 인스턴스에서 OSS를 실행하여, 패키지 또는 독립 실행형 빌드 없이 지원되는 흐름을 테스트할 수 있습니다.

### PlayFabUnreal 플러그인

PlayFabUnreal 플러그인은 핵심 PlayFab 기능을 제공합니다:

* **PlayFab Core**: 모든 PlayFab 작업의 기반이 되는 인증 및 이벤트 파이프라인(텔레메트리) 서비스
* **PlayFab Services**: 리더보드, 이코노미, 플레이어 데이터, 통계 및 카탈로그 관리를 포함한 게임 기능
* **PlayFab 게임 저장**: 장치와 세션 간 플레이어 진행 상황을 보존하기 위한 크로스 플랫폼 클라우드 저장

## 시작하기

설정 지침 및 자세한 문서는 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 게임 저장](/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)