---
title: Multiplayer 세션 빌딩 블록
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/building-blocks/multiplayer/sessions
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/building-blocks/multiplayer/sessions.md
last_updated: 2026-10-30
generated_at: 2026-11-20T07:36:16.096Z
locale: ko-kr
---

# Multiplayer 세션 빌딩 블록

> 이 빌딩 블록의 사전 제작된 UI 요소를 사용하여 프로젝트에 Unity Multiplayer 세션을 구현합니다.

이 Unity 빌딩 블록의 사전 제작된 UI 요소를 사용하여 Unity의 [Multiplayer 세션](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual.md)을 프로젝트에 구현합니다. 세션이 무엇인지, 설정하는 방법, 디버깅하는 방법, Unity Netcode 패키지에 연결하는 방법을 알아봅니다.

## 소개##introduction

Multiplayer 세션 빌딩 블록을 사용하면 Unity Multiplayer 세션을 프로젝트에 통합하여 플레이어를 연결할 수 있습니다. 이 빌딩 블록은 Multiplayer 프로젝트의 시작점이거나 개발 과정에서 세션을 빠르게 통합할 수 있습니다.

이 빌딩 블록은 다음을 수행하는 방법을 보여 줍니다.

* Multiplayer Services SDK를 통해 세션을 생성하고 참여합니다.
* 빠른 참여 API 사용하여 기존 세션에 플레이어를 빠르게 연결할 수 있습니다.
* 세션 브라우징 API 사용하여 기존 세션을 나열하고 특정 세션에 참여합니다.
* JoinCode를 사용하여 특정 세션을 공유하고 참여합니다.

Multiplayer 세션 빌딩 블록에는 예제 씬, UIToolkit UI 에셋, 런타임 컴포넌트가 포함되어 있으며, 이를 통해 세션을 생성하고, 탐색하고, 참여하고, SessionInfo 패널을 사용하여 디버깅할 수 있습니다. 게임플레이 동기화가 필요한 경우 Unity [Netcode for GameObjects](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual/build-your-first-session.md) 또는 [Netcode for Entities](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual/build-with-netcode-for-entities.md)를 사용하여 Netcode를 추가할 수 있습니다.

## 필수 조건##prerequisites

* Unity Asset Store에서 [Unity 빌딩 블록 - Multiplayer 세션](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-multiplayer-session-341930)을 설치합니다.。
* [Unity 에디터 프로젝트를 클라우드 프로젝트에 연결](https://docs.unity.com/en-us/cloud/projects/configure-project-for-unity-cloud.md)합니다.

## 초안 수립##initial-setup

빌딩 블록이 올바르게 설치되었는지 확인하려면 [포함된 예시 씬](#included-resources) 중 하나를 엽니다.

1. **Assets** > **Blocks** > **MultiplayerSession** > **Scenes**로 이동하여 Multiplayer 씬을 엽니다.
2. 플레이 모드를 시작하려면 **재생**을 선택합니다.

이제 씬의 UI 요소와 상호 작용하여 새 세션을 생성할 수 있습니다.

## Multiplayer 세션##multiplayer-sessions

[Multiplayer 세션](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual.md)은 연결된 플레이어 그룹을 나타내며 초기 플레이어 연결, 호스트 선택, 참여 및 떠나기, 네트워크 연결 설정 등 Multiplayer 게임 상태를 관리하기 위한 추상화 레이어를 제공합니다. Multiplayer 세션은 게임플레이 동기화를 용이하게 하지 않지만 플레이어가 연결된 후 권한 있는 게임 상태 복제를 처리할 수 있는 [Netcode for GameObjects](https://docs.unity3d.com/Packages/com.unity.netcode.gameobjects@latest) 또는 [Network for Entities](https://docs.unity3d.com/Packages/com.unity.netcode@latest)와 호환됩니다. 예를 들어 일반적인 연결 플로는 다음과 같습니다.

1. Unity 서비스 초기화
2. 플레이어 인증
3. 세션 생성 또는 참여
4. 적절한 네트워크 서버 또는 호스트에 연결
5. 게임플레이 씬 로드

## 포함된 리소스##included-resources

Multiplayer 세션 빌딩 블록에는 다음과 같은 씬이 포함되어 있습니다.

| 씬              | 설명                                                                                                         |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| JoinByBrowsing | 플레이어가 이용 가능한 세션을 살펴보고 참여하거나 새 세션을 직접 생성할 수 있습니다. 특정 설정이나 플레이어가 있는 로비를 찾는 데 이상적입니다.                         |
| JoinByCode     | 플레이어가 세션을 생성하고 다른 플레이어가 세션에 참여하는 데 사용할 수 있는 간단한 참여 코드를 공유하도록 합니다. 코드를 복사하여 특정 세션에 참여하고 플레이어를 초대하는 데 적합합니다. |
| QuickJoin      | 플레이어가 사용 가능한 첫 번째 세션에 참여하도록 합니다. 특정 규칙과 일치하지 않는 경우 기존 세션에 빠르게 참여하기에 적합합니다.                                 |
| QuickJoinDebug | QuickJoin과 비슷하지만 세션에 대한 정보가 포함된 SessionInfo 창이 추가되어 있습니다. 세션 디버깅에 유용합니다.                                   |

### JoinByBrowsing##joinbybrowsing

`SessionBrowser` UXML:

* `CreateSessionElement`: 세션 이름을 지정하고 세션을 생성합니다.
* `SessionBrowserElement`: 사용 가능한 세션을 표시합니다. 클릭 수 세션을 선택합니다.
* `RefreshListButton`: `SessionBrowserElement`의 세션 목록을 새로 고칩니다.
* `JoinButton`: 목록에서 선택한 세션에 참여합니다.

`CurrentSession` UXML:

* `SessionNameLabel`: 시청된 세션의 이름을 표시합니다.
* `PlayerCountLabel`: 시청된 세션의 플레이어 수를 표시합니다.
* `PlayerNameLabel`: 플레이어의 이름을 표시합니다.
* `CopySessionCodeElement`: 복사할 수 있도록 세션의 참여 코드를 표시합니다.
* `PlayerListView`: 세션에 참여한 플레이어의 목록을 표시합니다.
* `LeaveSessionButton`: 참여 세션을 나가려면 선택합니다.

### JoinByCode##joinbycode

`JoinSessionByCode` UXML:

* `CreateSessionElement`: 세션 이름을 지정하고 세션을 생성합니다.
* `CopySessionCodeElement`: 복사할 수 있도록 세션의 참여 코드를 표시합니다.
* `JoinSessionByCode`: 세션에 참여할 세션 코드를 입력합니다.

`CurrentSession` UXML:

* `SessionNameLabel`: 시청된 세션의 이름을 표시합니다.
* `PlayerCountLabel`: 시청된 세션의 플레이어 수를 표시합니다.
* `PlayerNameLabel`: 플레이어의 이름을 표시합니다.
* `CopySessionCodeElement`: 복사할 수 있도록 세션의 참여 코드를 표시합니다.
* `PlayerListView`: 세션에 참여한 플레이어의 목록을 표시합니다.
* `LeaveSessionButton`: 참여 세션을 나가려면 선택합니다.

### QuickJoin##quickjoin

`JoinSessionByQuickJoin` UXML:

* `QuickJoinButton`: [빠른 참여 API](https://docs.unity.com/ugs/manual/lobby/manual/quick-join.md)를 사용하여 세션에 참여합니다.

`CurrentSession` UXML:

* `SessionNameLabel`: 시청된 세션의 이름을 표시합니다.
* `PlayerCountLabel`: 시청된 세션의 플레이어 수를 표시합니다.
* `PlayerNameLabel`: 플레이어의 이름을 표시합니다.
* `CopySessionCodeElement`: 복사할 수 있도록 세션의 참여 코드를 표시합니다.
* `PlayerListView`: 세션에 참여한 플레이어의 목록을 표시합니다.
* `LeaveSessionButton`: 참여 세션을 나가려면 선택합니다.

### QuickJoinDebug##quickjoindebug

`JoinSessionByQuickJoin` UXML:

* `QuickJoinButton`: [빠른 참여 API](https://docs.unity.com/ugs/manual/lobby/manual/quick-join.md)를 사용하여 세션에 참여합니다.

`SessionInfo` UXML:

* `SessionInfo`: 활성 세션에 대한 디버깅 정보를 표시하며, [세션 뷰어](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual/session-viewer.md)와 유사합니다.

`CurrentSession` UXML:

* `SessionNameLabel`: 시청된 세션의 이름을 표시합니다.
* `PlayerCountLabel`: 시청된 세션의 플레이어 수를 표시합니다.
* `PlayerNameLabel`: 플레이어의 이름을 표시합니다.
* `CopySessionCodeElement`: 복사할 수 있도록 세션의 참여 코드를 표시합니다.
* `PlayerListView`: 세션에 참여한 플레이어의 목록을 표시합니다.
* `LeaveSessionButton`: 참여 세션을 나가려면 선택합니다.

## 로컬에서 여러 클라이언트와 참여##joining-with-multiple-clients-locally

[Multiplayer Play Mode](https://docs.unity3d.com/Packages/com.unity.multiplayer.playmode@latest)를 사용하여 Unity 에디터에서 직접 여러 플레이어로 설정을 테스트합니다.

## 세션에 Netcode 추가##add-netcode-to-a-session

Netcode for GameObjects 또는 Netcode for Entities 세션에 연동하려면 다음을 수행합니다.

1. 패키지 관리자(**창** > **패키지 관리자** > **패키지 관리자**)를 사용하여 원하는 Netcode 패키지를 설치합니다.
   * [Unity Netcode for GameObjects](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual/build-your-first-session.md#build-a-session-with-netcode-for-gameobjects) 또는 [Netcode for Entities](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual/build-with-netcode-for-entities.md#build-a-session-with-netcode-for-entities)를 설치합니다.

2. `SessionSettings`에서 **네트워크 세션 생성**을 활성화합니다.
   * `SessionSettings` ScriptableObject에서 선택한 Netcode 솔루션으로 세션을 인식하고 관리할 수 있는 **네트워크 세션 생성** 옵션을 찾아 활성화합니다.

3. `SessionSettings`에서 **네트워크 타입**을 변경합니다.

   * `SessionSettings` 내에서 원하는 네트워크 아키텍처와 일치하도록 **네트워크 타입**을 조정합니다. 다음 중에서 선택할 수 있습니다.

     * Relay 클라우드 기반 Relay 서비스의 경우
     * 분산된 권한: Netcode for GameObjects 사용하는 경우
     * 직접: IP 주소 및 포트를 사용하는 직접 연결의 경우.

다양한 NetworkTypes에 대해 자세히 알아보려면 [네트워크 연결 관리](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual/manage-session-network-connection.md#types-of-network)를 참고하십시오.

## 문제 해결##troubleshooting

### Multiplayer Services 사용할 수 없음##multiplayer-services-not-available

* Multiplayer Services 초기화해야 합니다. ServicesInitialization 및 PlayerAuthentication 컴포넌트를 추가하여 기본 설정으로 자체 씬을 초기화할 수 있습니다.

### Authentication 실패##authentication-failure

* 에디터에 로그인했는지, 프로젝트 ID가 올바른지 확인합니다.
* 서비스 활성화(예: Authentication 및 Lobby)를 확인합니다.

### 세션을 나열하거나 참여할 수 없음##can't-list-or-join-sessions

* 네트워크 연결 및 방화벽 규칙 확인
* Lobby 서비스 상태와 할당량을 확인하십시오.

#### 참여 코드가 유효하지 않거나 만료되었습니다.##join-code-invalid-or-expired

* 영향을 받는 세션이 활성 상태이고 용량이 아님을 확인합니다.
* 세션을 다시 생성하여 참여 코드를 다시 생성합니다.
* Relay 활성화되고 지역을 사용할 수 있는지 확인합니다.
* Netcode 시작하기 전에 엔드포인트가 설정되었는지 확인합니다.

### UI가 데이터를 표시하지 않음##ui-not-showing-data

* UXML의 각 `VisualElement`에 해당 `SessionType`가 올바르게 설정되어 있는지 확인합니다.

## 추가 리소스##additional-resources

* Unity 서비스 Multiplayer SDK]\([https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual.md))
* [Unity Netcode for GameObjects](https://docs.unity3d.com/Packages/com.unity.netcode.gameobjects@latest)
* [Unity Netcode for Entities](https://docs.unity3d.com/Packages/com.unity.netcode@latest)
