언리얼 엔진의 스위치보드 퀵스타트 | 언리얼 엔진 5.7 문서

이 페이지에서는 스위치보드를 시작하는 방법을 단계별로 설명합니다. 튜토리얼을 마치고 나면 스위치보드를 구성하여 여러 디바이스에 연결하는 방법을 알 수 있게 됩니다.

전제 조건

다음 단계를 완료하기 전에 다음과 같은 구성이 필요합니다.

스위치보드(Switchboard) 플러그인을 활성화합니다. 플러그인을 추가하고 언리얼 엔진을 재시작하면 스위치보드 및 스위치보드 리스너 옵션이 툴바에 표시됩니다.

이미지를 클릭하면 확대됩니다.
종속성이 설치되어 있어야 합니다. 메인 메뉴에서 편집(Edit) > 에디터 개인설정(Editor Preferences) > 플러그인(Plugins) > 스위치보드 를 선택하고 종속성 설치(Install Dependencies) 를 클릭합니다.

이미지를 클릭하면 확대됩니다.
(선택 사항) Windows 운영체제를 사용하는 경우 바탕 화면에 스위치보드의 바로가기를 설치하도록 선택할 수도 있습니다. 메인 메뉴에서 편집 > 프로젝트 세팅(Project Settings) > 플러그인 > 스위치보드 를 선택하고 바로가기 추가(Add Shortcut) 를 클릭합니다.

이미지를 클릭하면 확대됩니다.
엔진을 소스에서 빌드한 경우 스위치보드 리스너(SwitchboardListener) 를 별도로 빌드해야 합니다. Visual Studio에서 프로젝트를 빌드하거나 엔진 소스 코드의 루트 디렉터리에서 Engine\Binaries\DotNET\UnrealBuildTool.exe Win64 Development SwitchboardListener 명령을 실행할 수 있습니다.

1단계 - 스위치보드 리스너 실행

스위치보드에 연결할 각 디바이스에서 스위치보드 리스너를 실행해야 합니다. 툴바에서 스위치보드 옵션(Switchboard Options) > 스위치보드 리스너 실행(Launch Switchboard Listener) 을 선택하여 디폴트 주소 0.0.0.0:2980 또는 에디터 개인설정(Editor Preferences) 에서 리스너 명령줄 실행인자(Listener Commandline Arguments) 로 설정한 주소로 로컬 머신에서 리스너를 실행합니다.

리스너는 창을 자동으로 최소화하여 nDisplay 디바이스와의 문제를 방지합니다. 이 애플리케이션은 OS의 작업 표시줄에서 확인할 수 있습니다.

또한 로그인 시 스위치보드 리스너 실행(Launch Switchboard Listener on Login) 을 선택하여 컴퓨터에 로그인할 때마다 로컬 머신에서 리스너를 실행할 수도 있습니다.

2단계 - 스위치보드 실행

스위치보드는 여러 가지 방법을 사용하여 실행할 수 있습니다.

언리얼 에디터에서 프로젝트를 열고 툴바에서 스위치보드 실행(Launch Switchboard) 을 선택합니다.
컴퓨터에 바탕 화면 바로가기를 설치한 경우 바로가기를 사용합니다. 바로가기 설치 방법에 대한 자세한 내용은 스위치보드 전제 조건을 참고하세요.
Engine\Plugins\VirtualProduction\Switchboard\Source\Switchboard\Switchboard.bat 를 실행합니다.

스위치보드가 처음으로 실행되면 새 스위치보드 환경설정 추가(Add new Switchboard Configuration) 창이 표시됩니다. 각 필드를 채우고 확인(OK) 을 선택하거나 취소(Cancel) 를 선택하고 나중에 스위치보드 세팅(Switchboard Settings)에서 업데이트할 수도 있습니다. 두 옵션 모두 스위치모드를 창에서 실행합니다.

스위치보드 환경설정 파라미터:

파라미터	설명
이름(Name)	스위치보드 프로젝트를 식별하는 데 사용할 이름입니다.
uProject	스위치보드를 통해 제어할 uProject의 로컬 경로입니다.
엔진 디렉터리(Engine Dir)	사용할 언리얼 엔진의 엔진 디렉터리에 대한 로컬 경로입니다. 소스에서 빌드한 언리얼 엔진 또는 설치된 언리얼 엔진 출시 버전 경로를 지정할 수 있습니다. 예시: 'C:\Program Files\Epic Games\UE_5.00\Engine'
Perforce	이 체크박스를 활성화하면 Perforce를 소스 저장소로 사용할 수 있습니다.
P4 프로젝트 경로(P4 Project Path)	위에서 지정한 uProject 파일을 포함하는 디렉터리에 대한 디포 경로입니다.
P4 엔진 경로(P4 Engine Path)	위에서 지정한 언리얼 엔진 디렉터리에 대한 디포 경로입니다. 소스로부터 엔진을 빌드할 계획이 아니라면 생략이 가능합니다.
워크스페이스 이름(Workspace Name)	uProject 디렉터리가 매핑된 로컬에서 사용 가능한 Perforce 워크스페이스 이름입니다.

3단계 - 스위치보드에서 디바이스 추가

스위치보드는 다양한 타입의 디바이스를 지원하며, 이러한 디바이스는 스위치보드의 플러그인으로 구현됩니다. 기본적으로 사용할 수 있는 디바이스 플러그인의 목록 및 자신만의 디바이스 플러그인을 생성하는 방법에 대한 자세한 내용은 스위치보드 세팅을 참고하세요.

다음 예시는 언리얼 디바이스를 추가하는 방법입니다.

스위치보드에서 디바이스 추가(Add Device) > 언리얼(Unreal) 을 선택하여 언리얼 디바이스 추가(Add Unreal Device) 창을 엽니다.
'언리얼 디바이스 추가' 창에서 언리얼 엔진을 실행하는 머신에 대한 이름과 컴퓨터의 IP 주소를 할당합니다. 확인 을 선택합니다. 해당 디바이스가 스위치보드의 언리얼 디바이스 목록에 추가됩니다.

디바이스를 추가한 다음에 해당 IP 주소 및 이름을 변경할 수도 있습니다.

리스너에 연결(Connect to Listener) 을 클릭하여 원격 머신에서 실행 중인 스위치보드 리스너 애플리케이션에 연결합니다. 디바이스가 연결되면 상태 아이콘이 파란색으로 바뀝니다.
언리얼 시작(Start Unreal) 을 클릭하여 원격 머신에서 언리얼 에디터의 인스턴스를 실행합니다.
언리얼 인스턴스가 실행되면 왼쪽의 상태 아이콘이 주황색 또는 초록색으로 바뀝니다.
- 초록색 상태는 언리얼 인스턴스가 OSC를 통해 연결되어 스위치보드에서 테이크 레코더를 사용할 수 있다는 것을 의미합니다.
- 주황색 상태는 언리얼 인스턴스가 OSC를 통해 연결되지 않았다는 것을 의미합니다.
언리얼 중지(Stop Unreal) 를 클릭하여 원격 머신에서 언리얼 에디터를 닫습니다.

4단계 - 직접 해보기

이 퀵스타트에서는 스위치보드 및 스위치보드 리스너를 시작하고, 원격 디바이스에 연결하고, 스위치보드에서 디바이스를 제어하는 방법에 대해 살펴봤습니다. 스위치보드 세팅 레퍼런스에서는 스위치보드를 통해 변경할 수 있는 전체 옵션 목록을 참고할 수 있습니다. 프로젝트에서 다음과 같은 기능을 사용하는 방법에 대해 더 알아보세요.

프로젝트와 언리얼 엔진의 원격 동기화 및 빌드
스위치보드에서 원격으로 테이크 녹화
nDisplay 클러스터 실행 및 모니터링