# 시작하기

> Install and configure the Unity Gaming Services Software Development Kit plug-in for Unreal Engine.

다음 가이드를 사용하여 Unity Gaming Services SDK 플러그인을 설치하고 구성하는 방법을 확인할 수 있습니다. Unity Gaming Services SDK를 프로젝트에 설치하고 구성한 후, Unity Matchmaker용 [C++](./integrate-using-cpp.md) 또는 [블루프린트](./integrate-using-blueprints.md)를 사용할 수 있습니다.

### 포함된 제품##what's-included

Unity Gaming Services SDK에는 Unity의 세 가지 서비스가 하나의 플러그인에 빌트인되어 포함됩니다.

* [Unity Authentication](/authentication.md)
* [Unity Matchmaker](/matchmaker.md)
* [Unity Multiplay Hosting](https://www.rocketscience.gg/multiplay/)

### 요구 사항 파악##understand-the-requirements

Unreal Engine용 Matchmaker SDK 플러그인은 Unreal Engine 버전 4.27\~5.3을 지원합니다.

> **Warning:**
>
> 현재 Unity Matchmaker는 [Unity Multiplay Hosting](https://www.rocketscience.gg/multiplay/)을 사용하여 호스팅되는 전용 서버로 플레이어 매치메이킹만 지원합니다. Multiplay Hosting은 비용이 발생할 수 있습니다. 자세한 가격 정보는 [가격 책정](https://unity.com/solutions/gaming-services/pricing)을 참조하십시오.

> **Warning:**
>
> Unity Matchmaker는 서버에서 이벤트를 처리하기 위해 Centrifuge라는 프로토콜을 사용합니다. 이는 플러그인 모듈인 `MatchmakerServer`에 포함되어 있습니다. Centrifuge는 비PC 플랫폼에서는 지원되지 않으므로, 클라이언트 빌드에서 `MatchmakerServer` 모듈을 제외하려면 `.uproject` 파일에서 여러 게임 모듈과 `TargetAllowList`를 사용해야 합니다.

## Matchmaker SDK 다운로드##download-the-matchmaker-sdk

### Unreal Engine Marketplace 웹사이트에서##from-the-unreal-engine-marketplace-website

1. [Unreal Engine Marketplace](https://www.unrealengine.com/marketplace/en-US/store)에 로그인합니다.

2. [Unity Gaming Services SDK for Unreal Engine 마켓플레이스](https://www.unrealengine.com/marketplace/en-US/product/unity-gaming-services-sdk-for-unreal-engine) 페이지에 액세스합니다.


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine 마켓플레이스 페이지](/api/media?file=/matchmaker/media/images/unreal-ugs-marketplace-page.png)

3. **Open in Launcher**를 선택합니다.

4. [Epic Games Launcher](#from-the-epic-games-launcher)의 4단계로 건너뜁니다.

### Epic Games 런처에서##from-the-epic-games-launcher

1. Epic Games 런처에 로그인합니다.
2. Epic Games 런처에서 **Unity Gaming Services SDK for Unreal Engine**을 검색합니다.


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine 검색](/api/media?file=/matchmaker/media/images/unreal-auth-marketplace-search.png)
3. Unity Gaming Services SDK for Unreal Engine 페이지에 액세스하여 **Free**를 선택합니다.


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine 런처 페이지](/api/media?file=/matchmaker/media/images/unreal-ugs-epic-launcher-page.png)
4. Epic Games 런처에서 **Install to Engine**을 선택합니다.


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine 설치 버튼](/api/media?file=/matchmaker/media/images/unreal-ugs-marketplace-install.png)
5. 새 프로젝트 또는 기존 프로젝트를 엽니다.
6. 플러그인 창으로 이동하여 Unity Gaming Services SDK for Unreal Engine 옆의 체크박스를 선택합니다.


   **Frame:**
   ![Unity Gaming Services SDK for Unreal Engine 플러그인 창](/api/media?file=/matchmaker/media/images/unreal-ugs-engine-plugin.png)
7. Unreal Engine을 다시 시작합니다.

> **Note:**
>
> **참고**: 소스로 빌드된 엔진 버전을 사용하는 경우 다음을 수행하여 Marketplace 폴더에 액세스할 수 있습니다.
>
> * Windows를 사용하는 경우 기본 경로는 `C:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Marketplace`입니다. MacOS와 Linux도 비슷한 경로를 사용합니다.
> * `UnityGamingServicesSDK` 폴더를 프로젝트 `Plugins` 폴더에 복사합니다. 아직 폴더가 없는 경우 프로젝트의 루트에서 생성합니다.

### Matchmaker SDK 구성##configure-the-matchmaker-sdk

Unity Matchmaker는 Unity Gaming Services SDK에 포함된 Unity Authentication 서비스를 기반으로 작동합니다.

먼저 [Unity Dashboard](https://cloud.unity.com/)에서 Unity Matchmaker 설정을 구성한 다음, Matchmaker API를 호출하고 Matchmaker를 사용하여 플레이어를 할당해야 합니다. 그렇지 않으면 모든 매치메이킹 요청이 실패합니다. Unity Matchmaker에는 [기본 풀이 있는 최소 하나의 대기열](/matchmaker/advanced-topics-queues-pools.md)이 필요합니다.

#### Backfill 구성##configure-backfill

Backfill을 사용하여 최대 플레이어 수보다 적은 기존 매치에 플레이어를 배정할 수 있습니다. 자세한 내용은 [Backfill 기술 자료](/matchmaker/advanced-topics-backfill.md)를 참조하십시오.

먼저 Unity Dashboard에서 대기열에 대해 Backfill을 활성화한 다음 Backfill을 사용해야 합니다.

1. [Unity Dashboard](https://cloud.unity.com/)로 이동하여 프로젝트를 선택합니다.
2. **Multiplayer** 탭으로 이동합니다.
3. **Matchmaker** 탭으로 이동하여 **Queues**를 선택합니다.
4. **Queue**를 선택합니다. [대기열과 풀 생성](/matchmaker/get-started.md#create-a-queue-and-a-pool)을 참조하십시오.
5. **Pools** 탭으로 이동하여 대기열 내에서 사용할 풀을 선택합니다.
6. **Rules** 탭으로 이동하여 Backfill이 활성화된 필드를 찾아 **True**로 설정되어 있는지 확인합니다.

## 다음 단계##what's-next-?

두 연동 중 하나를 진행합니다.

* [C++ 연동](./integrate-using-cpp.md)
* [블루프린트 연동](./integrate-using-blueprints.md)