스위치보드 퀵스타트

스위치보드를 프로젝트에 추가하고 여러 디바이스에 원격으로 연결하는 방법을 살펴봅니다.

Choose your operating system:

Windows

macOS

Linux

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

전제 조건

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

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

    Click image to expand

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

    Click image to expand

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

    Click image to expand

  • 언리얼 엔진을 소스에서 빌드한 경우 스위치보드 리스너 를 별도로 빌드해야 합니다. 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단계 - 스위치보드 실행

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

  1. 언리얼 에디터에서 프로젝트를 열고 툴바에서 스위치보드 실행(Launch Switchboard) 을 선택합니다.

    언리얼 에디터 툴바에서 스위치보드 실행

  2. 컴퓨터에 바탕 화면 바로가기를 설치한 경우 바로가기를 사용합니다. 바로가기 설치 방법에 대한 자세한 내용은 [스위치보드 전제 조건(Switchboard Prerequisites)]()을 참고하세요.

  3. 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단계 - 스위치보드에서 디바이스 추가

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

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

  1. 스위치보드에서 디바이스 추가(Add Device) > 언리얼(Unreal) 을 선택하여 언리얼 디바이스 추가(Add Unreal Device) 창을 엽니다.

    스위치보드에 언리얼 디바이스를 추가합니다.

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

    언리얼 디바이스 추가 창

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

  1. 리스너에 연결(Connect to Listener) 을 클릭하여 원격 머신에서 실행 중인 스위치보드 리스너 애플리케이션에 연결합니다. 디바이스가 연결되면 상태 아이콘이 파란색으로 바뀝니다.

    스위치보드 리스너에 연결

  2. 언리얼 시작(Start Unreal) 을 클릭하여 원격 머신에서 언리얼 에디터의 인스턴스를 실행합니다.

    언리얼 인스턴스 원격 시작

  3. 언리얼 인스턴스가 실행되면 왼쪽의 상태 아이콘이 주황색 또는 초록색으로 바뀝니다.

    • 초록색 상태는 언리얼 인스턴스가 OSC를 통해 연결되어 스위치보드에서 테이크 레코더를 사용할 수 있다는 것을 의미합니다.

    • 주황색 상태는 OSC를 통해 연결되지 않았다는 것을 의미합니다.

    주황색 상태의 예시

  4. 언리얼 중지(Stop Unreal) 를 클릭하여 원격 머신에서 언리얼 에디터를 닫습니다.

    언리얼 인스턴스 원격 중지

4단계 - 직접 해보기

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

  • 프로젝트와 언리얼 엔진의 원격 동기화 및 빌드

  • 스위치보드에서 원격으로 테이크 녹화

  • nDisplay 클러스터 실행 및 모니터링

태그