스위치 액터(Switch Actor)는 레벨에서 액터의 비저빌리티 또는 전체 계층구조를 빠르게 토글할 수 있도록 해줍니다.
스위치 액터의 한 자손만 표시할 수 있습니다. 표시하려는 자손 액터를 선택하면 스위치 액터가 모든 후손과 함께 다른 모든 자손 액터를 자동으로 숨깁니다. 그런 다음 선택된 자손 액터의 모든 후손과 함께 선택한 하나의 자손 액터를 표시합니다.
이러한 행동은 한 번에 하나의 액터 또는 계층구조만 표시되어야 하는 상호 배타적인 레벨 액터 또는 액터 계층구조를 가지고 있는 경우 가장 유용합니다. 예를 들어 자동차 컨피규레이터는 서로 다른 몇 가지 트림을 제공할 수 있습니다. 아래의 이미지에서와 같이 이러한 각각의 트림은 서로 다른 지오메트리를 가지고 있는 다양한 스태틱 메시 액터 세트로 표현됩니다.

표시되는 자동차의 모델을 한 트림 옵션에서 다른 트림 옵션으로 전환하려면 여러 액터를 표시하고 숨겨야 합니다. 이는 블루프린트 또는 '베리언트 매니저(Variant Manager)'를 사용하거나 언리얼 에디터에서 수동으로 가능합니다. 하지만 수십 또는 수백 개 액터의 비저빌리티를 동시에 변경하는 것은 어려울 수 있습니다. 모든 트림 옵션을 위한 부모로 스위치 액터를 사용하는 경우, 스위치 액터 부모에서 단 하나의 옵션만 설정하여 서로 다른 트림 사이를 손쉽게 전환할 수 있습니다.
스위치 액터는 에디터(Editor) > 베리언트 매니저 콘텐츠(Variant Manager Content) 플러그인에 포함되어 있습니다. 보통 이 플러그인은 기본적으로 활성화되어 있습니다. 하지만 모드(Modes) 패널에서 스위치 액터를 찾을 수 없는 경우 프로젝트에서 이 플러그인을 활성화해야 합니다.
레벨에 스위치 액터 추가하기
스위치 액터 는 액터 배치(Place Actors) 패널의 모든 클래스(All Classes) 탭에 있습니다. 스위치 액터를 액터 배치 패널에서 '레벨 뷰포트(Level Viewport)'로 드래그합니다.

표시할 자손 액터 선택하기
다음 섹션에서는 스위치 액터의 자손 중 표시할 자손을 선택하는 다양한 방법을 설명합니다.
언리얼 에디터의 경우
월드 아웃라이너(World Outliner) 에서 스위치 액터를 선택합니다. 디테일(Details) 패널에서 스위치 액터 > 선택된 옵션(Selected Option) 세팅을 찾습니다. 이 드롭다운에는 부모가 스위치 액터인 모든 자손 액터의 이름이 나열됩니다.

표시할 옵션을 선택합니다.
블루프린트의 경우
스위치 액터는 선택한 자손으로 작업하는 데 사용할 수 있는 블루프린트 API를 제공합니다. 참조에서 블루프린트 그래프에 있는 스위치 액터로 바로 드래그할 경우 스위치 액터 카테고리에 다음과 같은 노드가 나열된 것을 확인할 수 있습니다.

노드 | 이름 | 설명 |
---|---|---|
![]() |
Get Options | 현재 이 스위치 액터가 부모인 모든 자손 액터에 참조 배열을 반환합니다. |
![]() |
Get Selected Option | 현재 표시된 자손 액터의 인덱스를 반환합니다. |
![]() |
Select Option | 지정한 인덱스로 자손을 선택하기 위해 스위치 액터를 변경합니다. |
Get Options 를 통해 반환된 배열은 월드 아웃라이너 또는 스위치 액터의 디테일 패널에 표시된 자손 액터와 동일한 순서를 가지지 않을 수 있습니다. 또한 Get Selected Option 을 통해 반환된 인덱스 숫자와 Select Option 을 호출할 때 지정한 인덱스 숫자는 모두 이 배열 내 요소를 식별합니다.
베리언트 매니저의 경우
스위치 액터를 '베리언트 매니저'의 베리언트에 바인딩하면 선택된 옵션(Selected Option) 프로퍼티가 캡처됩니다. 값(Values) 열에는 부모가 스위치 액터인 모든 자손 액터의 이름이 나열된 드롭다운이 표시됩니다.
이 베리언트가 켜질 때 표시할 옵션을 선택합니다.