언리얼 엔진의 라이브 링크 VRPN | 언리얼 엔진 5.7 문서

라이브 링크(Live Link) 는 OpenVR이 지원되는 VRPN 서버를 통해 노출된 디바이스를 지원합니다. VRPN은 VR 주변 기기들에 추상 레이어를 제공함으로써 주변 기기들이 모두 같은 데이터 보고서를 가지고 있는 것처럼 보이게 해줍니다. VRPN의 특성상, 같은 디바이스에 여러 개의 라이브 링크 서브젝트(Live Link Subjects) 를 매핑할 수 있습니다.

시작하기

라이브 링크 VRPN 으로 디바이스를 설정하려면 다음 단계를 따르세요.

VRPN 서버를 시작합니다.

해당 VRPN 서버는 OpenVR을 반드시 지원해야 합니다.
언리얼 엔진 을 시작하고 프로젝트를 엽니다.
다음 플러그인을 활성화합니다.
1. 라이브 링크(Live Link)
2. 라이브 링크 VRPN(Live Link VRPN)
언리얼 엔진을 재시작합니다.
언리얼 에디터의 메인 메뉴 에서 창(Window) > 라이브 링크(Live Link) 를 선택하여 라이브 링크 창을 엽니다.
소스 추가(Add Source) 를 클릭하고 라이브 링크 VRPN 소스(Live Link VRPN Source) 를 선택합니다.

사용자가 선택한 라이브 링크 VRPN 소스로, 연결 세팅(Connection Settings) 패널을 보여줍니다. 이것은 기본 세팅입니다.
연결 세팅 창에서 다음 단계를 따릅니다.
1. IP 주소(IPAddress) 에 VRPN 서버의 IP 주소와 포트 번호를 입력합니다. 이 예시에서 VRPN 서버는 로컬 컴퓨터에서 3884 포트를 사용하여 실행되므로 텍스트 값은 127.0.0.1:3884입니다.
2. VRPN 서버를 폴링할 빈도로 로컬 업데이트 속도(Hz)(Local Update Rate in Hz) 를 설정합니다. 기본값은 120이고 최댓값은 1000입니다.
3. 디바이스 이름(Device Name) 을 디바이스의 VRPN 서버에서 사용하는 ID로 설정합니다. 일련번호는 변하지 않으므로 일반적인 디바이스 ID보다 일련번호를 사용하는 편이 더 좋습니다.
  
  이 예시에서 VRPN 서버는 왼쪽 VR 컨트롤러에 openvr/controller/1GNGH850VE0304_Controller_Left라는 ID를 사용합니다.
4. 서브젝트 이름(Subject Name) 을 원하는 이름으로 설정합니다. 이것이 라이브 링크 서브젝트 이름 이 됩니다. 이 예시에서 서브젝트 이름은 LeftController_VRPNTracker입니다.
5. 타입(Type) 을 다음 중 하나로 설정합니다.
  - 트래커(Tracker) : 디바이스의 위치와 오리엔테이션을 언리얼 트랜스폼으로 반환합니다.
  - 아날로그(Analog): 조이스틱이나 디바이스의 슬라이더와 같은 하나 이상의 아날로그 축을 0~1의 범위로 반환합니다.
  - 다이얼(Dial) : 다이얼과 같은 디바이스의 회전을 나타내는 float을 반환합니다.
  - 버튼(Button) : 0 또는 1 값으로 float의 배열을 반환합니다.
6. 추가(Add) 를 클릭합니다.
첫 번째 데이터가 수신되면, 명명한 이름의 라이브 링크 서브젝트가 VRPN 섹션 밑에 표시됩니다. 이 예시에서 서브젝트 이름은 LeftController_VRPNTracker입니다.

라이브 링크 VRPN 서브젝트가 표시되지 않으면 아래 문제 해결 섹션에서 데이터를 확실히 수신하는 방법에 대한 팁을 참조하세요.
트래커 타입인 경우: 레벨에서 액터(Actor) 를 선택하고 여기에 LiveLinkComponentController 를 추가합니다. 라이브 링크 VRPN 서브젝트에 서브젝트 표시(Representation) 를 설정합니다. 이 예시에서 서브젝트는 LeftController_VRPNTracker입니다.

기타 타입인 경우: 기타 타입은 float이므로 블루프린트 에서 사용하여 씬을 수정합니다.

축 매핑의 오리엔테이션 재정렬하기

VRPN은 일반 축 매핑을 강제 적용하지 않으므로 라이브 링크는 라이브 링크 프리프로세서를 사용하여 축 매핑의 오리엔테이션을 재정렬하는 컨트롤을 제공합니다.

아래 단계에 따라 언리얼 엔진에서 디바이스의 축 매핑을 변경하세요.

라이브 링크 창에서 라이브 링크 VRPN 서브젝트 를 클릭합니다.
뷰 옵션(View Options) > 서브젝트 프로퍼티(Subject Properties) 를 클릭합니다.
프리프로세서(Pre Processors) 옆의 추가(Add (+)) 버튼을 클릭하여 라이브 링크 프리프로세서를 추가합니다.
프리프로세서 엘리먼트를 트랜스폼 축 스위치(Transform Axis Switch) 로 설정하고 섹션을 펼칩니다.
전면(Front) , 오른쪽(Right) , 위쪽 축(Up Axes) 을 디바이스의 좌표계와 일치하도록 변경합니다. VRPN 서버마다 기본 축 매핑이 다를 수 있으며 디바이스마다 자체적인 축 매핑이 있을 수 있습니다. 자세한 내용은 VRPN 서버의 문서 또는 환경설정 파일을 참조하세요. 이 예시의 디바이스는 Z 앞쪽, +X 오른쪽, +Y 위쪽을 사용합니다.
축이 예상대로 움직이면 오프셋 위치(Offset Position) 또는 오프셋 회전(Offset Rotation) 을 활성화합니다. 필요한 경우 월드에서 올바른 오리엔테이션 또는 위치를 얻도록 오프셋을 설정합니다.

문제 해결하기

라이브 링크 소스를 추가할 때 라이브 링크 VRPN 서브젝트가 표시되지 않으면 다음 팁을 참고하여 문제를 해결해 보세요.

라이브 링크에 지정된 IP 주소와 포트가 VRPN 서버와 일치하는지 확인합니다.
데이터의 스트림이 VRPN에서 올바르게 전송되는 경우 같은 서버에서 LiveLinkXR 플러그인을 사용하여 문제를 해결할 수 있습니다.
라이브 링크에서 라이브 링크 VRPN 서브젝트를 선택하고 뷰 옵션 > 프레임 데이터 표시(Show Frame Data) 를 클릭한 후 언리얼 엔진이 어떤 데이터를 수신하는지 확인하세요.