Multiplayer 세션 빌딩 블록
이 빌딩 블록의 사전 제작된 UI 요소를 사용하여 프로젝트에 Unity Multiplayer 세션을 구현합니다.
읽는 시간 4분최근 업데이트: 9일 전
이 Unity 빌딩 블록의 사전 제작된 UI 요소를 사용하여 Unity의 Multiplayer 세션을 프로젝트에 구현합니다. 세션이 무엇인지, 설정하는 방법, 디버깅하는 방법, Unity Netcode 패키지에 연결하는 방법을 알아봅니다.
소개
Multiplayer 세션 빌딩 블록을 사용하면 Unity Multiplayer 세션을 프로젝트에 통합하여 플레이어를 연결할 수 있습니다. 이 빌딩 블록은 Multiplayer 프로젝트의 시작점이거나 개발 과정에서 세션을 빠르게 통합할 수 있습니다.
이 빌딩 블록은 다음을 수행하는 방법을 보여 줍니다.
- Multiplayer Services SDK를 통해 세션을 생성하고 참여합니다.
- 빠른 참여 API 사용하여 기존 세션에 플레이어를 빠르게 연결할 수 있습니다.
- 세션 브라우징 API 사용하여 기존 세션을 나열하고 특정 세션에 참여합니다.
- JoinCode를 사용하여 특정 세션을 공유하고 참여합니다.
Multiplayer 세션 빌딩 블록에는 예제 씬, UIToolkit UI 에셋, 런타임 컴포넌트가 포함되어 있으며, 이를 통해 세션을 생성하고, 탐색하고, 참여하고, SessionInfo 패널을 사용하여 디버깅할 수 있습니다. 게임플레이 동기화가 필요한 경우 Unity Netcode for GameObjects 또는 Netcode for Entities를 사용하여 Netcode를 추가할 수 있습니다.
필수 조건
- Unity Asset Store에서 Unity 빌딩 블록 - Multiplayer 세션을 설치합니다.。
- Unity 에디터 프로젝트를 클라우드 프로젝트에 연결합니다.
초안 수립
빌딩 블록이 올바르게 설치되었는지 확인하려면 포함된 예시 씬 중 하나를 엽니다.
- Assets > Blocks > MultiplayerSession > Scenes로 이동하여 Multiplayer 씬을 엽니다.
- 플레이 모드를 시작하려면 재생을 선택합니다.
이제 씬의 UI 요소와 상호 작용하여 새 세션을 생성할 수 있습니다.
Multiplayer 세션
Multiplayer 세션은 연결된 플레이어 그룹을 나타내며 초기 플레이어 연결, 호스트 선택, 참여 및 떠나기, 네트워크 연결 설정 등 Multiplayer 게임 상태를 관리하기 위한 추상화 레이어를 제공합니다. Multiplayer 세션은 게임플레이 동기화를 용이하게 하지 않지만 플레이어가 연결된 후 권한 있는 게임 상태 복제를 처리할 수 있는 Netcode for GameObjects 또는 Network for Entities와 호환됩니다. 예를 들어 일반적인 연결 플로는 다음과 같습니다.
- Unity 서비스 초기화
- 플레이어 인증
- 세션 생성 또는 참여
- 적절한 네트워크 서버 또는 호스트에 연결
- 게임플레이 씬 로드
포함된 리소스
Multiplayer 세션 빌딩 블록에는 다음과 같은 씬이 포함되어 있습니다.
씬 | 설명 |
|---|---|
| JoinByBrowsing | 플레이어가 이용 가능한 세션을 살펴보고 참여하거나 새 세션을 직접 생성할 수 있습니다. 특정 설정이나 플레이어가 있는 로비를 찾는 데 이상적입니다. |
| JoinByCode | 플레이어가 세션을 생성하고 다른 플레이어가 세션에 참여하는 데 사용할 수 있는 간단한 참여 코드를 공유하도록 합니다. 코드를 복사하여 특정 세션에 참여하고 플레이어를 초대하는 데 적합합니다. |
| QuickJoin | 플레이어가 사용 가능한 첫 번째 세션에 참여하도록 합니다. 특정 규칙과 일치하지 않는 경우 기존 세션에 빠르게 참여하기에 적합합니다. |
| QuickJoinDebug | QuickJoin과 비슷하지만 세션에 대한 정보가 포함된 SessionInfo 창이 추가되어 있습니다. 세션 디버깅에 유용합니다. |
JoinByBrowsing
SessionBrowser- : 세션 이름을 지정하고 세션을 생성합니다.
CreateSessionElement - : 사용 가능한 세션을 표시합니다. 클릭 수 세션을 선택합니다.
SessionBrowserElement - :
RefreshListButton의 세션 목록을 새로 고칩니다.SessionBrowserElement - : 목록에서 선택한 세션에 참여합니다.
JoinButton
CurrentSession- : 시청된 세션의 이름을 표시합니다.
SessionNameLabel - : 시청된 세션의 플레이어 수를 표시합니다.
PlayerCountLabel - : 플레이어의 이름을 표시합니다.
PlayerNameLabel - : 복사할 수 있도록 세션의 참여 코드를 표시합니다.
CopySessionCodeElement - : 세션에 참여한 플레이어의 목록을 표시합니다.
PlayerListView - : 참여 세션을 나가려면 선택합니다.
LeaveSessionButton
JoinByCode
JoinSessionByCode- : 세션 이름을 지정하고 세션을 생성합니다.
CreateSessionElement - : 복사할 수 있도록 세션의 참여 코드를 표시합니다.
CopySessionCodeElement - : 세션에 참여할 세션 코드를 입력합니다.
JoinSessionByCode
CurrentSession- : 시청된 세션의 이름을 표시합니다.
SessionNameLabel - : 시청된 세션의 플레이어 수를 표시합니다.
PlayerCountLabel - : 플레이어의 이름을 표시합니다.
PlayerNameLabel - : 복사할 수 있도록 세션의 참여 코드를 표시합니다.
CopySessionCodeElement - : 세션에 참여한 플레이어의 목록을 표시합니다.
PlayerListView - : 참여 세션을 나가려면 선택합니다.
LeaveSessionButton
QuickJoin
JoinSessionByQuickJoin- : 빠른 참여 API를 사용하여 세션에 참여합니다.
QuickJoinButton
CurrentSession- : 시청된 세션의 이름을 표시합니다.
SessionNameLabel - : 시청된 세션의 플레이어 수를 표시합니다.
PlayerCountLabel - : 플레이어의 이름을 표시합니다.
PlayerNameLabel - : 복사할 수 있도록 세션의 참여 코드를 표시합니다.
CopySessionCodeElement - : 세션에 참여한 플레이어의 목록을 표시합니다.
PlayerListView - : 참여 세션을 나가려면 선택합니다.
LeaveSessionButton
QuickJoinDebug
JoinSessionByQuickJoin- : 빠른 참여 API를 사용하여 세션에 참여합니다.
QuickJoinButton
SessionInfo- : 활성 세션에 대한 디버깅 정보를 표시하며, 세션 뷰어와 유사합니다.
SessionInfo
CurrentSession- : 시청된 세션의 이름을 표시합니다.
SessionNameLabel - : 시청된 세션의 플레이어 수를 표시합니다.
PlayerCountLabel - : 플레이어의 이름을 표시합니다.
PlayerNameLabel - : 복사할 수 있도록 세션의 참여 코드를 표시합니다.
CopySessionCodeElement - : 세션에 참여한 플레이어의 목록을 표시합니다.
PlayerListView - : 참여 세션을 나가려면 선택합니다.
LeaveSessionButton
로컬에서 여러 클라이언트와 참여
Multiplayer Play Mode를 사용하여 Unity 에디터에서 직접 여러 플레이어로 설정을 테스트합니다.
세션에 Netcode 추가
Netcode for GameObjects 또는 Netcode for Entities 세션에 연동하려면 다음을 수행합니다.
-
패키지 관리자(창 > 패키지 관리자 > 패키지 관리자)를 사용하여 원하는 Netcode 패키지를 설치합니다.
-
에서 네트워크 세션 생성을 활성화합니다.
SessionSettings- ScriptableObject에서 선택한 Netcode 솔루션으로 세션을 인식하고 관리할 수 있는 네트워크 세션 생성 옵션을 찾아 활성화합니다.
SessionSettings
-
에서 네트워크 타입을 변경합니다.
SessionSettings-
내에서 원하는 네트워크 아키텍처와 일치하도록 네트워크 타입을 조정합니다. 다음 중에서 선택할 수 있습니다.
SessionSettings- Relay 클라우드 기반 Relay 서비스의 경우
- 분산된 권한: Netcode for GameObjects 사용하는 경우
- 직접: IP 주소 및 포트를 사용하는 직접 연결의 경우.
-
다양한 NetworkTypes에 대해 자세히 알아보려면 네트워크 연결 관리를 참고하십시오.
문제 해결
Multiplayer Services 사용할 수 없음
- Multiplayer Services 초기화해야 합니다. ServicesInitialization 및 PlayerAuthentication 컴포넌트를 추가하여 기본 설정으로 자체 씬을 초기화할 수 있습니다.
Authentication 실패
- 에디터에 로그인했는지, 프로젝트 ID가 올바른지 확인합니다.
- 서비스 활성화(예: Authentication 및 Lobby)를 확인합니다.
세션을 나열하거나 참여할 수 없음
- 네트워크 연결 및 방화벽 규칙 확인
- Lobby 서비스 상태와 할당량을 확인하십시오.
참여 코드가 유효하지 않거나 만료되었습니다.
- 영향을 받는 세션이 활성 상태이고 용량이 아님을 확인합니다.
- 세션을 다시 생성하여 참여 코드를 다시 생성합니다.
- Relay 활성화되고 지역을 사용할 수 있는지 확인합니다.
- Netcode 시작하기 전에 엔드포인트가 설정되었는지 확인합니다.
UI가 데이터를 표시하지 않음
- UXML의 각 에 해당
VisualElement가 올바르게 설정되어 있는지 확인합니다.SessionType
추가 리소스
- Unity 서비스 Multiplayer SDK](https://docs.unity.com/ugs/en-us/manual/mps-sdk/manual)
- Unity Netcode for GameObjects
- Unity Netcode for Entities