리모트 컨트롤 프리셋(Remote Control Preset) 을 사용하면 하나의 패널로 모든 UI 파라미터나 함수를 수집 및 정리하고 리모트 컨트롤 API에 노출할 수 있습니다. 파라미터와 함수는 리모트 컨트롤 웹 인터페이스(Remote Control Web Interface) 플러그인이 제공하는 컴패니언 웹 애플리케이션에서 위젯에 연결해 엔진을 원격으로 제어할 수 있습니다.
이 페이지에서는 언리얼 에디터의 프로퍼티와 함수를 리모트 컨트롤 API에 노출하는 방법을 알아봅니다. 리모트 컨트롤 패널의 모든 세팅에 대한 자세한 정보는 리모트 컨트롤 패널 레퍼런스를 참조하세요.
전제조건
리모트 컨트롤 API(Remote Control API) 플러그인은 데이터와 리모트 컨트롤 프리셋(Remote Control Preset) 의 웹소켓 연결을 호스트하는 웹 서버를 제공합니다.
프로젝트의 플러그인을 활성화하려면 다음 단계를 따르세요.
-
언리얼 에디터에서 프로젝트를 엽니다.
-
에디터의 메인 메뉴에서 편집(Edit) > 플러그인(Plugins) 으로 이동한 다음 플러그인(Plugins) 창을 엽니다.
-
플러그인(Plugins) 창에서 Messaging 카테고리에 있는 리모트 컨트롤 API(Remote Control API) 플러그인을 찾습니다. 활성화됨(Enabled) 체크박스를 선택합니다.
-
엔진을 다시 시작합니다.
리모트 컨트롤 패널과 리모트 컨트롤 API에 프로퍼티 노출하기
언리얼 에디터(Unreal Editor) 의 리모트 컨트롤 패널(Remote Control Panel) 에 레벨의 여러 오브젝트에 대한 프로퍼티를 모아서 쉽게 사용할 수 있습니다. 패널에 함수를 추가하고 호출할 수도 있습니다. 리모트 컨트롤 패널(Remote Control Panel) 에 노출된 프로퍼티와 함수는 리모트 컨트롤 API(Remote Control API) 에도 노출됩니다. 따라서 사용자는 라이브 환경에서 제어해야 하는 모든 항목을 쉽게 정리할 수 있습니다.
아래 단계를 따라 리모트 컨트롤 프리셋(Remote Control Preset) 을 추가하고 리모트 컨트롤 패널(Remote Control Panel) 을 엽니다.
-
콘텐츠 브라우저(Content Browser) 에서 우클릭하고 기타(Miscellaneous) 섹션으로 이동합니다. 리모트 컨트롤 프리셋(Remote Control Preset) 을 선택합니다.
-
리모트 컨트롤 프리셋 에셋(Remote Control Preset Asset) 을 더블클릭해서 리모트 컨트롤 패널(Remote Control Panel) 을 엽니다.
-
편집 모드(Edit Mode) 체크박스를 선택합니다.
-
에셋(Assets) 의 디테일(Details) 패널을 보면 모든 프로퍼티 옆에 눈을 감거나 뜬 상태의 아이콘이 생겼을 것입니다.
-
눈 아이콘은 프로퍼티가 리모트 컨트롤 패널(Remote Control Panel) 에 추가되었는지를 나타냅니다.
- 뜬 눈 아이콘은 프로퍼티가 리모트 컨트롤 패널에 추가되었음을 나타냅니다.
- 감은 눈 아이콘은 프로퍼티가 리모트 컨트롤 패널에 추가되지 않았음 을 나타냅니다.
- 뜬 눈 아이콘을 클릭해서 감은 눈으로 바꾸거나 감은 눈을 뜬 눈으로 바꾸면, 프로퍼티가 리모트 컨트롤 패널에 추가되거나 제거됩니다.
-
리모트 컨트롤 패널에 추가된 프로퍼티는 디테일(Details) 패널과 인터페이스가 같습니다.
리모트 컨트롤 패널(좌)과 디테일 패널(우)에서 보이는 RGB 값 라이트 색(Light Color) 프로퍼티
-
리모트 컨트롤 프리셋(Remote Control Preset) 에서 우클릭하고 저장(Save) 을 선택해 변경 내용을 저장합니다.
블루프린트 라이브러리를 통해 프로퍼티 및 함수 노출하기
이 기능은 실험단계 기능이며 다음 출시에서 변경될 수 있습니다.
블루프린트 라이브러리(Blueprint Library)로 프로퍼티, 함수, 액터를 리모트 컨트롤 API에 노출하고, 리모트 컨트롤 프리셋 채우기 프로세스를 자동화할 수 있습니다. 블루프린트를 통한 노출 방법은 블루프린트 API를 참조하세요.
아래 블루프린트 예시의 함수는 클래스 BP_Tree_S 의 모든 계층구조를 노출하도록 구성되었습니다.
이미지를 클릭해 펼칩니다.
함수가 작동하면, 리모트 컨트롤 프리셋이 클래스 BP_Tree_S 의 모든 계층구조를 표시합니다.
이미지를 클릭해 펼칩니다.
다음 단계
이 가이드에서는 리모트 컨트롤 API에 프로퍼티를 노출하고 리모트 컨트롤 프리셋을 생성하는 법을 알아봤습니다. 라이브 환경에서 노출된 프로퍼티를 사용하는 방법은 아래 문서를 참조하세요.