언리얼 엔진의 스위치보드 세팅 레퍼런스 | 언리얼 엔진 5.7 문서

이 페이지에서는 스위치보드에 대해 변경할 수 있는 세팅을 설명합니다.

스위치보드 플러그인 세팅

스위치보드(Switchboard) 플러그인 세팅에 액세스하려면 언리얼 에디터의 메인 메뉴에서 편집(Edit) > 프로젝트 세팅(Project Settings) > 플러그인(Plugins) > 스위치보드(Switchboard) 를 선택합니다.

플러그인 세팅에서 OSC 리스너(OSC Listener)를 설정할 수 있습니다. 스위치보드에서 테이크 레코더를 사용하려면 OSC 리스너를 필요로 합니다. 자세한 정보는 스위치보드로 테이크 레코딩하기 페이지를 참고하세요. 에디터 개인설정(Editor Preferences)의 스위치보드 플러그인에서 스위치보드가 필수 종속성을 실행 및 설치하는 방식을 구성할 수 있습니다. 다음 테이블은 에디터 개인설정에서 설정 가능한 파라미터를 설명합니다.

파라미터	설명
스위치보드(Switchboard)
가상 환경 패스(Virtual Environment Path)	스위치보드의 디폴트 Python 버전은 Python 3.7.7입니다. 다른 Python 버전을 사용하려면 머신의 다른 Python 인터프리터를 나타내도록 이 필드를 변경하세요.
스위치보드 리스너(Switchboard Listener)
리스너 명령줄 실행인자(Listener Commandline Arguments)	스위치보드 리스너는 다음 실행 인자를 받습니다. `-ip` : 스위치보드 리스너가 리슨할 IP 주소를 설정합니다. `-port` : 스위치보드 리스너가 리슨할 포트를 설정합니다.
로그인 시 스위치보드 리스너 실행(Launch Switchboard Listener on Login)	활성화하면 컴퓨터에 로그인할 때마다 스위치보드 리스너(Switchboard Listener)가 로컬 머신에서 실행됩니다.

스위치보드 세팅

초기 프로젝트 구성 도중 추가된 값을 포함하여 모든 디바이스 플러그인에 공통적인 세팅은 세팅(Settings) 패널의 일반 섹션에 있습니다. 디바이스를 추가한 뒤 이러한 디바이스에 대한 세팅이 세팅 패널에 추가되며, 디바이스 타입을 바탕으로 세팅을 필터링할 수 있도록 왼쪽에 탭이 표시됩니다.

일부 일반 세팅은 디바이스 세팅에서 반복되므로 필요 시 디바이스별로 값을 오버라이드할 수 있습니다. 특정 디바이스에서 세팅을 오버라이드하면 다른 배경색이 나타납니다. 오버라이드가 적용 중일 때는 글로벌 세팅을 변경해도 디바이스에서 이 세팅이 변경되지 않습니다.

다음 섹션에서는 세팅 패널에서 수정 가능한 모든 세팅을 설명합니다.

일반 세팅

파라미터	설명
환경설정 경로(Config Path)	스위치보드 환경설정이 저장되는 경로입니다. 이 파일에는 모든 스위치보드 스테이트가 들어 있습니다.
IP 주소(IP Address)	스위치보드 및 내부 OSC 서버를 실행하는 머신의 IP 주소입니다. 스위치보드를 실행하는 컴퓨터에 다수의 네트워크 컨트롤러가 있다면 이 주소를 변경하세요.
이동 경로(Transport Path)	현재는 스위치보드에서 사용되지 않습니다.
리스너 실행 파일 이름(Listener Executable Name)	스위치보드 리스너 애플리케이션 실행에 사용할 프로그램 이름입니다.

프로젝트 세팅

파라미터	설명
프로젝트 이름(Project Name)	스위치보드 프로젝트의 이름입니다. 세팅과 디바이스가 저장될 파일명의 기준으로 사용됩니다.
UProject	언리얼 엔진 프로젝트 파일의 로컬 경로입니다.
엔진 디렉터리(Engine Directory)	언리얼 엔진 디렉터리의 로컬 경로입니다.
빌드 엔진(Build Engine)	스위치보드에서 소스로부터 엔진을 빌드하도록 지원하는 플래그입니다.
맵 경로(Map Path)	Content 폴더에서부터 스위치보드의 레벨(Level) 드롭다운에 표시될 맵까지의 상대적 경로입니다.
맵 필터(Map Filter)	레벨 드롭다운에 표시되는 맵을 제한하는 파일 필터입니다.
OSC
OSC 서버 포트(OSC Server Port)	스위치보드가 리슨하는 OSC 서버의 포트입니다.
OSC 클라이언트 포트(OSC Client Port)	언리얼 에디터에서 지정된 OSC 클라이언트의 포트입니다.
소스 컨트롤(Source Control)
워크스페이스 이름(Workspace Name)	디포 프로젝트 경로에 매핑되는 Perforce 워크스페이스의 이름입니다.
Perforce 프로젝트 경로(Perforce Project Path)	UProject에 지정된 언리얼 프로젝트에 대한 Perforce 디포 경로입니다. uproject 파일을 포함하는 디포 폴더만 지정하면 됩니다.
Perforce 엔진 경로(Perforce Engine Path)	P4 엔진 경로 세팅은 프로젝트가 아니라 소스로부터 엔진을 빌드할 계획일 때만 필요합니다. 자세한 정보는 동기화 및 빌드 페이지를 참조하세요.

멀티 유저 서버 세팅

파라미터	설명
서버 이름(Server Name)	전체 서버 이름을 만들기 위해 프로젝트 이름에 추가되는 이름입니다.
명령줄 실행인자(Command Line Args)	멀티 유저 서버 실행 파일에 전달되는 실행인자입니다(선택사항).
유니캐스트 엔드포인트(Unicast Endpoint)	실행 시 멀티 유저에 대해 지정되는 유니캐스트 엔드포인트입니다. 서버가 연결을 위해 리슨하는 포트이며, 프로젝트 세팅의 UDP 메시징(UDP Messaging) 세팅에 대응합니다. 디폴트 값은 0.0.0.0:9030 입니다.
멀티캐스트 엔드포인트(Multicast Endpoint)	멀티 유저가 구독해야 하는 멀티캐스트 그룹입니다. 동일한 멀티 유저 세션에 참여하는 모든 언리얼 노드는 동일한 멀티캐스트 엔드포인트를 가져야 합니다. 이 변수를 수정하는 것은 고급 환경설정에 해당합니다.
멀티유저 실행 파일 이름(Multiuser Executable Name)	멀티 유저 서버 세션을 실행하기 위한 프로그램 이름입니다.
자동 실행(Auto Launch)	이 옵션을 활성화하면 언리얼 또는 nDisplay 디바이스가 처음 시작될 때 멀티 유저 서버를 실행합니다. 이 서버는 항상 스위치보드와 동일한 디바이스에서 실행됩니다.
이력 지우기(Clean History)	실행인자 `-ConcertClean` 을 서버에 전달하여 서버 세션의 작업 디렉터리가 실행 시 지워지게 합니다.
자동 빌드(Auto Build)	엔진 폴더에서 소스가 변경될 때 멀티 유저 서버가 다시 빌드되어야 하는 경우 이 옵션을 활성화합니다.
자동 엔드포인트(Auto Endpoint)	언리얼 에디터 또는 nDisplay 노드를 실행할 때 스태틱 엔드포인트가 할당되어야 하는 경우 이 옵션을 활성화합니다. 프로젝트 세팅에서 멀티 유저 서버 유니캐스트 엔드포인트에 스태틱 엔드포인트를 추가하는 것과 동일합니다.
언리얼 멀티 유저 서버 자동 참여(Unreal Multi-user Server Auto Join)	각 언리얼 엔진 또는 nDisplay 디바이스가 멀티 유저 서버에 자동으로 참여하게 하려면 이 옵션을 활성화합니다.

언리얼 디바이스 세팅

파라미터	설명
디바이스 녹화 여부	디바이스 타입이 시퀀스를 녹화할 예정이라면 이 옵션을 활성화합니다.
버퍼 크기(Buffer Size)	스위치보드 리스너에 연결된 소켓 클라이언트의 내부 버퍼 크기입니다.
명령줄 실행인자(Command Line Arguments)	선택 사항인 명령줄 실행인자입니다. 시작 시 언리얼 엔진에 전달됩니다.
ExecCmds	언리얼 엔진 시작 시 명령줄 실행인자로 전달되는 `-ExecCmds` (콘솔 명령)을 설정합니다.
DPCVars	디바이스 프로필 콘솔 변수를 쉼표로 구분된 목록으로 전달합니다.
리스너 포트(Listener Port)	리스너가 리슨하는 포트 번호입니다. 디폴트 포트는 2980입니다.
역할 파일명(Roles Filename)	버추얼 프로덕션 역할을 포함하는 .ini 파일의 파일명입니다.
스테이지 세션 ID(Stage Session ID)	스테이지 모니터(Stage Monitor)의 공급자와 모니터를 그룹화하는 ID입니다. 세션 ID가 서로 다른 인스턴스는 스테이지 모니터에서 서로 보이지 않습니다.
언리얼 에디터 파일명(Unreal Editor filename)	언리얼 에디터 실행 파일의 파일명입니다.
GPU 개수(Number of GPUs)	디바이스에서 사용할 GPU가 2개 이상일 경우의 GPU 개수입니다.
프로세스 우선순위(Process Priority)	프로세스의 우선순위를 오버라이드합니다.
패키지 복원 건너뛰기(Skip Package Recovery)	시작 시 복원 프롬프트를 건너뛰고 자동 저장된 패키지를 자동으로 버립니다. 자동 저장에서 복원하는 것이 바람직하지 않은 멀티 유저 시나리오에서 유용합니다.
유니캐스트 엔드포인트(Unicast Endpoint)	노드에 대한 유니캐스트 엔드포인트입니다. 보통 디폴트로 할당된 값을 두면 됩니다. 스위치보드는 IP 주소가 :0으로 할당된 스위치보드의 이름을 사용합니다.
추가 스태틱 엔드포인트(Extra Static Endpoints)	언리얼 에디터 실행 시 설정할 추가 스태틱 엔드포인트입니다. 프로젝트 세팅에서 UDP 메시징 에 대해 설정된 스태틱 엔드포인트 세팅에 대응합니다.
멀티캐스트 엔드포인트(Multicast Endpoint)	멀티캐스트 엔드포인트를 오버라이드합니다.
로그 다운로드 디렉터리(Log Download Dir)	원격 디바이스에서 수집된 로그 및 언리얼 인사이트(Unreal Insights) 트레이스 파일이 저장되는 폴더입니다. 디폴트 경로는 폴더의 프로젝트 디렉터리인 /Saved/Logs/Switchboard 입니다.
에디터 비저빌리티를 게임에 반영(Reflect Editor Visibility to Game)	이 옵션을 활성화하면 게임에서 숨김(Hidden in Game) 등 `-game` 비저빌리티에 해당하는 오브젝트의 에디터 비저빌리티 상태를 멀티 유저 세션에서 반영합니다. 보통 nDisplay 환경설정에서 오퍼레이터 스테이션(Operator Station)에 대해 활성화하여 레벨 비저빌리티 변경 사항이 `-game` 인스턴스를 제대로 반영하게 하는 것이 좋습니다.
Rsync 서버 포트(Rsync Server Port)	스위치보드 애플리케이션에서 실행되는 rsync 서버에 할당된 포트입니다. rsync 서버는 대규모 데이터를 연결된 노드로부터 메인 스위치보드 인스턴스로 전송할 때 사용됩니다.
리스너 타임아웃(Listener Timeout)	스위치보드 리스너 프로세스의 타임아웃 기간입니다. 스위치보드 리스너가 주어진 타임아웃 기간 내에 메인 스위치보드 애플리케이션으로부터 메시지를 탐지하지 않을 경우 스위치보드 애플리케이션 연결이 해제됩니다.

각 언리얼 인스턴스:

파라미터	설명
IP 주소(IP address)	스위치보드 리스너가 리슨할 원격 주소입니다.
역할(Roles)	역할 .ini 파일에서 제공되는 버추얼 프로덕션 역할 선택을 활성화하는 드롭다운 메뉴입니다.
빌드에서 제외(Exclude from build)	활성화하면 이 노드에서 엔진 빌드가 발생하지 않습니다.
디바이스 녹화 여부(Is Recording Device)	이 디바이스가 녹화에 사용되는지 여부를 오버라이드합니다.
명령줄 실행인자	선택 사항인 명령줄 실행인자에 대한 오버라이드입니다.
ExecCmds	언리얼 엔진을 위한 실행 명령 오버라이드입니다.
DPCVars	디바이스 프로필 콘솔 변수에 대한 오버라이드입니다.
GPU 개수(Number of GPUs)	사용할 GPU 개수 오버라이드입니다.
프로세스 우선순위(Process Priority)	이 인스턴스의 우선순위를 오버라이드합니다.
패키지 복원 건너뛰기(Skip Package Recovery)	자동 저장된 패키지를 시작 시 자동으로 버릴지 여부를 오버라이드합니다.
유니캐스트 엔드포인트(Unicast Endpoint)	유니캐스트 엔드포인트를 오버라이드합니다.
추가 스태틱 엔드포인트(Extra Static Endpoints)	추가 스태틱 엔드포인트를 오버라이드합니다.
엔진 디렉터리(Engine Directory)	엔진에 대한 로컬 경로 오버라이드입니다.
워크스페이스 이름(Workspace Name)	Perforce 워크스페이스 이름을 오버라이드합니다.
uProject 경로	uproject 파일에 대한 로컬 경로 오버라이드입니다.

KiPro 디바이스 세팅

파라미터	설명
디바이스 녹화 여부	디바이스 타입이 시퀀스를 녹화할 예정이라면 이 옵션을 활성화합니다.
IP 주소	KiPro 웹 서버의 주소입니다.
정지 후 자동 재생(Auto Play After Stop)	이 옵션을 활성화하면 녹화가 끝날 때 자동으로 재생됩니다.

라이브 링크 페이스(Live Link Face)

파라미터	설명
디바이스 녹화 여부	디바이스 타입이 시퀀스를 녹화할 예정이라면 이 옵션을 활성화합니다.
IP 주소	현재 스위치보드에서 사용되지 않습니다.

모티브 디바이스 세팅(Motive Device Setttings)

파라미터	설명
디바이스 녹화 여부	디바이스 타입이 시퀀스를 녹화할 예정이라면 이 옵션을 활성화합니다.
모티브 명령 포트(Motive Command Port)	모티브 디바이스에 사용된 커뮤니케이션 포트입니다.
IP 주소	모티브 디바이스에 할당된 IP 주소입니다.

nDisplay 디바이스 세팅

파라미터	설명
nDisplay 환경설정 파일(nDisplay Config File)	.cfg 포맷과 JSON 포맷을 모두 지원합니다.
사용 가능한 코어 모두 사용(Use All Available Cores)	모든 코어를 사용하려면 이 옵션을 활성화합니다.
텍스처 스트리밍(Texture Streaming)	텍스처 스트리밍을 토글합니다.
렌더 API(Render API)	DirectX11 또는 DirectX12를 선택할 수 있습니다.
렌더 모드(Render Mode)	nDisplay 렌더 모드 선택을 허용합니다.
렌더 동기화 정책(Render Sync Policy)	자세한 정보는 렌더 동기화 정책 페이지를 참고하세요.
nDisplay 실행 파일명(nDisplay Executable Filename)	프로젝트에 대한 실행 파일명을 설정합니다. 패키지로 만든 빌드에 유용합니다.
추가 명령줄 실행인자(Extra Cmd Line Args)	시작 시 nDisplay에 전달되는 명령줄 실행인자(선택 사항)입니다.
ExecCmds	언리얼 엔진 시작 시 명령줄 실행인자로 전달되는 `-ExecCmds` (콘솔 명령)을 설정합니다.
DPCVars	디바이스 프로필 콘솔 변수를 쉼표로 구분된 목록으로 전달합니다.
언어텐디드(Unattended)	언어텐디드 애플리케이션이며 모든 대화창을 생략해야 한다고 나타내려면 이 옵션을 활성화합니다.
GPU 개수(Number of GPUs)	디바이스에서 사용할 GPU가 2개 이상일 경우의 GPU 개수입니다.
프로세스 우선순위(Process Priority)	프로세스의 우선순위를 오버라이드합니다.
실행 전 최소화(Minimize Before Launch)	nDisplay 노드를 실행하기에 앞서 호스트 컴퓨터에서 모든 창을 최소화해야 하는 경우 이 옵션을 활성화합니다.
로깅(Logging)	디바이스별로 제어될 수 있는 커스텀 로깅입니다.
유니캐스트 엔드포인트(Unicast Endpoint)	노드에 대한 유니캐스트 엔드포인트입니다. 보통 디폴트로 할당된 값을 두면 됩니다. 스위치보드는 IP 주소가 :0으로 할당된 스위치보드의 이름을 사용합니다.
추가 스태틱 엔드포인트(Extra Static Endpoints)	nDisplay 렌더러가 실행될 때 설정할 추가 스태틱 엔드포인트입니다. 프로젝트 세팅에서 UDP 메시징 에 대해 설정된 스태틱 엔드포인트 세팅에 대응합니다.
확인 비활성화(Disable Ensures)	실행 중인 인스턴스의 확인 조건을 비활성화합니다. 확인 조건은 계속 기록되지만, 인스턴스를 종료시키지는 않습니다.
모든 화면 메시지 비활성화(Disable All Screen Messages)	화면상의 메시지를 비활성화해야 하는 경우 이 옵션을 활성화합니다.
리스너 포트(Listener Port)	리스너가 리슨하는 포트 번호입니다. 디폴트 포트는 2980입니다.
역할(Roles)	역할 .ini 파일에서 제공되는 버추얼 프로덕션 역할 선택을 활성화하는 드롭다운 메뉴입니다.
스테이지 세션 ID(Stage Session ID)	스테이지 모니터(Stage Monitor)의 공급자와 모니터를 그룹화하는 ID입니다. 세션 ID가 서로 다른 인스턴스는 스테이지 모니터에서 서로 보이지 않습니다.

각 nDisplay 노드:

파라미터	설명
IP 주소(IP address)	스위치보드 리스너가 리슨할 원격 주소입니다.
역할(Roles)	역할 .ini 파일에서 제공되는 버추얼 프로덕션 역할 선택을 활성화하는 드롭다운 메뉴입니다.
빌드에서 제외(Exclude from build)	이 노드를 엔진 빌드에서 제외할지 여부를 오버라이드합니다.
UE 명령줄(UE Command Line)	이 노드에서 nDisplay 렌더러를 실행하기 위한 전체 명령입니다.
추가 명령줄 실행인자	선택 사항인 명령줄 실행인자에 대한 오버라이드입니다.
ExecCmds	nDisplay를 위한 실행 명령 오버라이드입니다.
DPCVars	디바이스 프로필 콘솔 변수에 대한 오버라이드입니다.
GPU 개수(Number of GPUs)	사용할 GPU 개수 오버라이드입니다.
프로세스 우선순위(Process Priority)	이 인스턴스의 우선순위를 오버라이드합니다.
유니캐스트 엔드포인트(Unicast Endpoint)	유니캐스트 엔드포인트를 오버라이드합니다.
추가 스태틱 엔드포인트(Extra Static Endpoints)	추가 스태틱 엔드포인트를 오버라이드합니다.
엔진 디렉터리(Engine Directory)	엔진에 대한 로컬 경로 오버라이드입니다.
워크스페이스 이름(Workspace Name)	Perforce 워크스페이스 이름을 오버라이드합니다.
uProject 경로	uproject 파일에 대한 로컬 경로 오버라이드입니다.

Shogun 디바이스 세팅

파라미터	설명
디바이스 녹화 여부	디바이스 타입이 시퀀스를 녹화할 예정이라면 이 옵션을 활성화합니다.
IP 주소	Shogun을 실행 중인 디바이스의 주소입니다.
저장 경로	Shogun의 캡처 폴더 경로입니다.

SoundDevices 디바이스 세팅

파라미터	설명
디바이스 녹화 여부	디바이스 타입이 시퀀스를 녹화할 예정이라면 이 옵션을 활성화합니다.
IP 주소	SoundDevices 웹 서버의 주소입니다.