이 페이지에서는 리모트 컨트롤 패널에 포함된 인터페이스 엘리먼트와 옵션을 살펴봅니다. 리모트 컨트롤 패널을 정리하고, 외부 디바이스를 연결하고, 리모트 컨트롤 API에서 더 쉽게 참조할 수 있도록 각 엘리먼트의 이름을 변경하는 법을 알려드립니다.
리모트 컨트롤 패널 인터페이스
이미지를 클릭하면 확대됩니다
메뉴
아래 표는 메뉴에 표시되는 각 엘리먼트를 왼쪽부터 오른쪽 순서로 설명한 것입니다.
| UI 엘리먼트 | 설명 |
|---|---|
| 그룹 만들기(Create Group) | 여러 그룹을 생성하여 비슷한 프로퍼티와 함수를 함께 정리합니다. |
| 노출(Expose) | 단순한 프로퍼티가 아닌 함수 기능을 노출하고 싶다면 패널에 다른 항목을 추가합니다. 아래와 같은 옵션을 리모트 컨트롤 API에 노출할 수 있습니다.
|
| 웹 앱 열기(Open Web App) | 리모트 컨트롤 웹 애플리케이션을 브라우저에서 실행합니다. |
| 편집 모드(Edit Mode) | 활성화하면 에디터의 프로퍼티를 노출하고, 함수를 프리셋에 추가하고, 프로퍼티와 함수의 그룹 및 위치를 수정할 수 있습니다. |
| 로그 활성화(Enable Log) | 프로토콜 로그를 표시합니다. 자세한 내용은 프로토콜 로그 섹션을 참조하세요. |
| 원격 제어 프리셋 이름 | 현재 열려 있는 원격 제어 프리셋 에셋의 이름을 표시합니다. |
노출된 프로퍼티
아래 표는 노출된 프로퍼티별로 표시되는 각 엘리먼트를 왼쪽부터 오른쪽 순서로 설명한 것입니다.
| 동작 | 설명 |
|---|---|
| 펼침(Expand) | (선택사항) 데이터 값에 추가 정보가 존재하는 경우 해당 정보를 표시합니다. |
| 이동(Move) | 패널의 각 엘리먼트를 드래그 앤 드롭해서 프로퍼티, 함수, 그룹을 다시 배열합니다. |
| 이름 바꾸기(Rename) | 함수 호출 시 분명하고 간단한 레퍼런스를 위해 프로퍼티, 함수, 그룹의 이름을 바꿉니다. |
| 데이터 값(Data Values) | 에디터의 프로퍼티에 대한 데이터 형식을 일치시킵니다. |
| 초기화(Reset) | 프로퍼티의 값을 디폴트로 되돌립니다. |
| 제거(Remove) | 패널에서 프로퍼티나 함수를 제거하고 리모트 컨트롤 API에 더는 노출되지 않도록 합니다. |
리모트 컨트롤 엔티티
이 섹션은 노출된 프로퍼티를 선택하면 표시됩니다. 아래 표는 각 프로퍼티에 연결할 수 있는 메타데이터를 설명한 것입니다. 일부 프로퍼티는 데이터 형식에 따라 필드가 더 많을 수도 있습니다.
| 메타데이터 | 설명 |
|---|---|
| 라벨(Label) | 리모트 컨트롤 프리셋의 라벨과 일치하는 프로퍼티 고유의 라벨입니다. 리모트 컨트롤 API에서 사용하면 노출된 프로퍼티에 액세스할 수 있습니다. |
| ID | 프로퍼티에 대한 엔진의 고유 식별자입니다. 리모트 컨트롤 API에서 사용하면 노출된 프로퍼티에 액세스할 수 있습니다. |
| 필드 이름(FieldName) | 관련 필드의 이름입니다. |
| 위젯(Widget) | 리모트 컨트롤 웹 애플리케이션에서 이 프로퍼티에 사용할 디폴트 위젯 유형입니다. |
| 설명(Description) | 이 필드는 리모트 컨트롤 웹 애플리케이션에 표시되는 라벨을 오버라이드합니다. |
DMX, MIDI, OSC용 리모트 컨트롤 프로토콜
원격 제어 패널에서는 DMX, MIDI, OSC를 통해 노출된 프로퍼티를 외부 디바이스에 매핑할 수 있습니다. 아래 표는 프로토콜 매핑(Protocol Mapping) 추가 및 확인용 UI를 설명한 것입니다.
| UI 엘리먼트 | 설명 |
|---|---|
| 프로토콜 매핑 옵션(Protocol Mapping Option) | 옵션은 다음과 같습니다.
|
| 프로토콜 추가(Add Protocol) | 프로토콜 매핑 옵션 드롭다운에서 현재 선택한 옵션에 새 프로토콜 매핑을 추가합니다. |
| 보기 옵션(Viewing Options) | 보고 싶은 프로토콜 매핑을 필터링합니다. |
각 프로토콜 매핑에는 연결할 외부 디바이스와 입력을 정의할 수 있는 별도의 매핑(Mapping) 및 범위(Ranges) 섹션도 있습니다. 아래 섹션에서는 프로토콜 유형별 매핑의 차이, 그리고 프로토콜 유형 사이에서 공유되는 기능의 범위를 설명합니다.
자동 바인딩 버튼을 사용하면 현재 프로토콜의 최신 입력을 캡처하여 매핑에 적용할 수 있습니다. 프로퍼티를 직접 지정하는 것보다 편리하고 빠른 방법입니다.
예를 들어, 기존 MIDI 바인딩이든 새로 만든 MIDI 바인딩이든, 자동 바인딩 버튼을 토글한 다음 디바이스에서 노트를 누르면 매핑 프로퍼티가 이에 따라 채워집니다. 자동 바인딩을 완료하고 새로운 입력에 대한 기록을 중단하려면 빨간색 자동 바인딩 버튼을 다시 토글합니다.
자동 바인딩의 상태는 아래와 같습니다. 회색(Grey) : 입력을 감지하지 않음 빨간색(Red) : 입력 감지 중 * 초록색(Green) : 바인딩된 입력 있음
DMX 프로토콜 매핑
아래 표는 DMX 프로토콜로 외부 디바이스의 특정 입력에 연결하는 옵션을 설명한 것입니다.
| 필드 | 설명 |
|---|---|
| 유니버스(Universe) | DMX 유니버스 매핑(DMX Universe Mapping) |
| LSB 사용(Use LSB) | 활성화하면, 16비트 DMX 값을 사용할 때 바이트 순서가 표준이 아닌 경우 가장 덜 중요한 비트를 사용해 순서를 변경합니다. 보통은 가장 중요한 비트가 사용됩니다. |
| 데이터 유형(Data Type) | 들어오는 데이터의 최댓값과 정확도를 지정합니다. 입력은 이 유형의 바운드로 제한됩니다. 가능한 유형은 아래와 같습니다.
현재 24비트 옵션은 내부적으로 저장되고 32비트 integer로 표시됩니다. |
| 시작 채널(Starting Channel) | 프로퍼티를 바인딩하는 DMX의 첫 채널입니다. 지금은 파라미터에 하나의 채널만 바인딩할 수 있습니다. |
MIDI 프로토콜 매핑
아래 표는 MIDI 프로토콜로 외부 디바이스의 특정 입력에 연결하는 옵션을 설명한 것입니다.
| 필드 | 설명 |
|---|---|
| 이벤트 유형(Event Type) | 입력 이벤트의 유형을 지정합니다. 디폴트 유형은 컨트롤 변경(Control Change)입니다. 사용할 수 있는 타입은 다음과 같습니다.
|
| 매핑된 채널 ID(Mapped Channel ID) | MIDI 디바이스 입력 식별자를 사용하여 연결할 디바이스를 지정합니다. |
| 채널(Channel) | 입력 MIDI 채널입니다. 값의 예상 범위는 0~16입니다. |
| 디바이스(Device) | 매핑할 디바이스를 선택합니다. 디폴트는 프로젝트 세팅에 설정된 디바이스입니다. 이름이나 ID로 디바이스를 설정해서 프로토콜 바인딩별로 디바이스를 오버라이드할 수도 있습니다. |
프로젝트 세팅(Project Settings) 에서 MIDI 디바이스를 지정하는 방법은 다음과 같습니다.
- 에디터에서 메인 메뉴로 이동한 뒤 프로젝트 세팅(Project Settings) 을 선택해서 프로젝트 세팅 창을 엽니다.
- 프로젝트 세팅(Project Settings) 창에서 플러그인(Plugins) > 리모트 컨트롤 MIDI 프로토콜(Remote Control MIDI Protocol) 로 이동합니다.
- 이름 또는 ID 로 디바이스를 선택합니다. 두 필드 옆의 드롭다운으로 사용할 수 있는 디바이스 목록을 확인할 수 있습니다. 현재 연결되지 않은 디바이스라면 원하는 디바이스를 지정할 수도 있습니다.
에디터가 열려 있는 동안 디바이스를 연결하는 경우, 새로 고침(Refresh) 버튼을 클릭해서 디바이스 목록을 새로 고침할 수 있습니다.
OSC 프로토콜 매핑
아래 표는 OSC 프로토콜로 외부 디바이스의 특정 입력에 연결하는 옵션을 설명한 것입니다.
| 필드 | 설명 |
|---|---|
| 경로 이름(Path Name) | OSC 디바이스의 서버 주소와 경로를 지정합니다. |
디폴트 서버는 127.0.0.1:8001입니다. 프로젝트 세팅에서 옵션을 변경하거나 추가할 수 있습니다.
- 에디터에서 메인 메뉴로 이동한 뒤 프로젝트 세팅(Project Settings) 을 선택해서 프로젝트 세팅 창을 엽니다.
- 프로젝트 세팅(Project Settings) 창에서 플러그인(Plugins) > 리모트 컨트롤 OSC 프로토콜(Remote Control MIDI Protocol) 로 이동합니다.
- 새 서버 세팅(Server Settings) 배열 엘리먼트를 추가하거나 기존 엘리먼트를 수정한 뒤 디바이스에 맞는 서버 주소(Server Address) 를 설정합니다.
프로토콜 범위
이 섹션에서는 외부 디바이스에 매핑되는 범위를 설명합니다. 기본적으로 새 프로토콜 매핑은 예상 최솟값과 최댓값에 상응하는 두 개의 범위 입력을 추가합니다.
범위 섹션 오른쪽의 더하기 버튼을 선택하면 범위 단계를 더 추가할 수 있습니다. 애니메이션 키프레임과 마찬가지로 범위 포인트에 다른 값을 입력하면 프로퍼티 값이 입력 포인트 사이에서 보간됩니다.
아래 표는 범위의 프로퍼티 값 설정 방법을 설명한 것입니다.
| UI 엘리먼트 | 설명 |
|---|---|
| 입력 범위 포인트(Input Range Point) | 특정 프로퍼티 값을 연결할 수 있는 입력 포인트입니다. |
| 데이터 값(Data Values) | 해당하는 범위 포인트의 프로퍼티 값을 설정합니다. 데이터 형식은 연결된 프로퍼티 유형과 일치합니다. |
| 현재 프로퍼티 값 사용(Use Current Property Value) | 레벨에 있는 프로퍼티의 현재 값을 캡처합니다. |
| 입력 제거(Remove Input) | 범위 포인트를 제거합니다. |
한 외부 디바이스의 동일한 입력에 둘 이상의 매핑이 있으면 경고 아이콘이 표시됩니다.
프로토콜 로그
리모트 컨트롤 패널 메뉴의 로그 활성화(Enable Log) 가 선택되어 있으면 선택한 프로토콜의 들어오는 데이터가 이 섹션에 표시됩니다. 아래 예시에서는 /1/fader4라는 이름의 OSC 디바이스가 엔진에 float 값을 전송하고 있습니다.
