반드시 버전에 맞는 “XROO 언리얼 엔진 플러그인”이 설치되어 있어야 합니다.
↓플러그인 다운로드↓
언리얼 플러그인이란?
XROO 언리얼 플러그인은 언리얼 엔진을 통해 제작한 콘텐츠를 XROO에서 편집과 배포를 할 수 있는 데이터 형태로 추출하여
자동으로 XROO에 투어를 만들어 주는 프로그램입니다.
이 가이드에서는 Unreal용 XROO PLUGIN을 설치하고 실행하여 XROO 투어를 생성하는 방법을 설명합니다.
플러그인 사용에 앞서 먼저 기본적인 개발 환경을 아래와 같이 설정합니다.
개발 환경 설정
1. 4.24 버전 이상의 Unreal Engine을 다운로드하여 설치합니다.
2. MS Visual Studio를 다운로드하여 설치합니다.
Tip: 아래 서술된 가이드의 순서대로 꼭 작업하지 않아도 됩니다.
플러그인 설치 이후 XROO 플러그인에서 제공하는 기능-콘텐츠(Scene, Marker)의 배치 및 투어 생성&불러오기-은 작업자 본인의 작업 스타일대로 진행하여도 무방합니다. 아래 가이드는 XROO 플러그인의 기능에 대해 전반적으로 설명하고자 순서를 구성한 것이오니 작업에 참고하세요.
1. 플러그인 설치 / 실행 / 로그인
XROO PLUGIN 설치 방법
1.
XROO에 로그인하여 “만들기”→”다운로드 센터”→"플러그인" 메뉴를 클릭합니다.
2.
페이지 하단에 플러그인 다운로드를 클릭합니다.
3.
본인이 사용하는 언리얼 버전에 맞는 플러그인을 다운로드합니다.
XROO 플러그인 가져오기
•
다운로드하고 압축 해제한 플러그인 폴더를 작업하고자 하는 프로젝트 폴더로 복사합니다.
◦
해당 프로젝트의 폴더명(작업하고자 하는 프로젝트)은 영문으로 구성되어야 XROO 플러그인의 정상적인 구동이 가능합니다.
•
해당 프로젝트의 폴더에 'Plugins' 폴더를 생성하고(해당 폴더가 있는 경우 진행하지 않아도 무방), Plugins 폴더에 다운로드한 XROO 플러그인 파일을 복사(이동)합니다.
•
언리얼을 실행하여, 플러그인을 설치(파일 이동)한 프로젝트를 오픈합니다.
•
프로젝트를 오픈하면 툴바에 XROO 플러그인이 설치/생성되었음을 확인할 수 있습니다.
◦
플러그인 아이콘을 클릭하면 로그인 창이 보입니다.
◦
XROO 홈페이지에서 사용하는 동일한 계정(구글, 페이스북, 카카오, 네이버)으로 로그인을 할 수 있으며,
◦
반드시 로그인을 해야 플러그인을 통해 XROO에 투어를 생성할 수 있습니다.
로그인을 시도할 때마다 자동으로 사용자 코드가 생성됩니다.
Sign in with Google (구글 로그인) 과정 안내
1. 로그인 창에 있는 Sign in with google 버튼을 클릭하세요.
2-1. 생성된 사용자 코드를 Copy 버튼을 눌러 복사하세요.
2-2. 동시에 브라우저로 오픈된 사용자 코드 입력 페이지에 2-1에서 복사한 사용자 코드를 입력하세요.
3. 유효성 체크가 완료되면 구글 로그인 계정 입력 페이지가 노출됩니다.
XROO 회원가입 시 사용한 구글 계정을 입력해 로그인을 진행하세요.
4. XROO 내 회원정보와 로그인 정보가 일치하면 플러그인이 활성화됩니다.
XROO의 크리에이터 계정이 없으시면 회원가입을 통해 계정을 생성해 주세요.
2. Import & Export
플러그인 ←→ XROO 데이터 동기화
‘Import’와 ‘Export’는 사용자의 업데이트 된 작업 데이터를 XROO의 투어와 언리얼의 프로젝트 중 각각
어느 곳으로 동기화할 것인지 선택하는 것을 의미합니다.
Import: XROO 투어의 변경된 작업 데이터를 언리얼의 프로젝트에 동기화 (XROO → Unreal)
Export: 언리얼의 프로젝트의 변경된 작업 데이터를 XROO투어에 동기화 (Unreal → XROO)
각 작업 환경 간의 화살표 방향은 데이터 이동방향을 뜻합니다.
•
XROO 투어의 데이터를 언리얼 레벨에 업데이트하고자 하는 경우 상단의 우향 화살표(가져오기 후, 보내기)를 클릭하여 업데이트하세요.
•
언리얼에서 작업한 데이터를 XROO 투어에 업데이트하고자 하는 경우, 하단의 우향 화살표(가져오기 후, 보내기)를 클릭하여 업데이트하세요.
중요: 어느 곳의 업데이트이든 최종 변경이 일어난 곳의 데이터를 플러그인으로 불러온(가져오기) 후, 업데이트(보내기)를 해야 합니다. 꼭 기억하세요!3. 투어 생성 / 불러오기
Create / Load 새 투어 생성 및 기존 투어 수정
1. 투어 생성 및 불러오기
XROO 계정으로 로그인이 완료되었다면, 위와 같이 Tour selection 탭에서 투어를 불러오거나 생성할 수 있는 화면이 보입니다.
• 상단 투어 목록에서 투어를 불러오고자 하는 경우 목록을 클릭하세요.
• 목록 우측에 Create New Tour를 클릭하면 새 투어를 생성할 수 있습니다.
새 투어를 생성했다면 "새로운 투어가 생성되었습니다." 팝업을 확인할 수 있습니다.
2. 투어 기본 정보 입력
Set 탭에서 투어 기본 정보인 Title, Theme을 입력합니다. 이 정보는 추후 XROO에서도 동일하게 수정할 수 있습니다.
• Title : 해당 투어의 타이틀을 지정해 주세요.
• Theme : 한 씬에 여러 장면을 설정하고자 하는 경우, 타이틀 우측 더하기 아이콘을 클릭하여 Theme을 추가 생성할 수 있습니다. Theme는 언리얼의 ‘서브 레벨’과 유사한 개념입니다.
4. 씬, 마커 생성
이동 포인트와 마커 설치
아이콘 타입 마커
뷰어 타입 마커
1. 씬 및 마커의 생성 및 조정
XROO 플러그인이 정상적으로 설치되었다면 콘텐츠 브라우저에서 XROO 콘텐츠를 확인할 수 있습니다.
해당 콘텐츠를 사용하여 레벨에 씬, 마커를 생성할 수 있습니다.
브라우저에서 "XROO 콘텐츠"를 선택하여 MarkerBP, SceneBP를 확인해 보세요.
•
씬을 추가하고자 하는 경우 SceneBP를 드래그, 마커를 추가하고자 하는 경우 MarkerBP를 드래그하여 레벨에 배치하세요.
•
레벨에 추가한 콘텐츠를 클릭 후, 콘텐츠에 붙어있는 x, y, z 축 화살표를 클릭하여 이동시키면 위치를 변경할 수 있습니다. 혹은 디테일 창에서 트랜스폼의 숫자 변경을 통해 위치 변경을 할 수 있습니다.
•
마커는 몇 가지 유형으로 공간 내에 배치할 수 있습니다.
◦
아이콘 타입 : 버튼을 눌러 팝업 형식으로 콘텐츠를 보여줄 수 있습니다.
◦
뷰어 타입 : 액자와 같은 형태로 사용자의 공간 탐험 중 곧바로 콘텐츠를 보여줄 수 있습니다.
◦
투명 타입 : 오브젝트의 모양대로 투명한 영역이 생성되어 오브젝트를 선택하면 첨부한 콘텐츠가 팝업 형식으로 화면에 출력됩니다.
•
마커도 씬 추가 방법과 마찬가지로 드래그하여 추가하고 위치 변경이 가능합니다.
마커의 경우, 디테일 창의 Function Type에서 해당 마커의 성격을 변경할 수 있습니다.
XROO 에서 제공하는 마커는 공간 내에 이미지, 비디오, PDF 등의 콘텐츠를 다양한 방식으로 배치하고 보여줄 수 있는 요소입니다.
•
각 마커의 기능에 대해 간단히 소개하면 다음과 같습니다.
- Icon: 아이콘 마커는 아이콘 노출 외 별도 기능을 가지고 있지 않습니다. 아이콘만 투어에 배치하고 싶을 때 이용하세요.
- Image: 이미지 슬라이더 마커로 이미지를 슬라이드 형식으로 보여줄 수 있습니다.
- Video: 비디오 마커로 영상 컨텐츠를 보여줄 수 있습니다.
- Iframe: 아이프레임 마커로 직접 제작한 html 페이지와 같은 컨텐츠를 보여줄 수 있습니다.
- Link: 링크 마커로 마커 클릭 시 다른 페이지로 이동하거나 새 창으로 외부 페이지를 보여줄 수 있습니다.
- Portal: 포털 마커로 투어 내 씬 이동을 원활하게 할 수 있습니다.
- Marker-Invisible: 투명 마커로 오브젝트 모양의 외곽선을 생성하여 강조할 수 있습니다.
- Viewer-Image: 이미지 뷰어로 이미지를 공간에 배치한 것처럼 보여줄 수 있습니다.
- Viewer-Video: 비디오 뷰어로 업로드한 비디오를 공간에 배치한 것처럼 보여줄 수 있습니다.
- Viewer-Videolink: 비디오 뷰어로 링크를 입력한 비디오를 공간에 배치한 것처럼 보여줄 수 있습니다.
마커의 성격은 언리얼에서만 변경 가능합니다. XROO에서는 마커의 상세 정보 설정만 가능하고 마커의 본래 성격을 변경할 수 없으므로 원하는 마커 모듈을 선택했는지 반드시 확인해 주세요.
위 과정을 통해 씬, 마커를 레벨에 드래그하고 위치를 조정해 보세요!
2. XROO 플러그인으로 가져오기
씬 및 마커를 생성하고 조정을 완료하였다면, 가져오기 버튼을 클릭해 현재 작업 중인 레벨의 정보를 XROO 플러그인으로 불러오세요.
가져오기가 완료되면, 투어 기본 정보 하단에 업데이트된 Scene, Marker 정보를 확인할 수 있습니다.
Tip: 해당 가져오기 작업은 먼저 씬/마커 생성 및 조정을 진행하신 후에 로그인 과정을 통해 수행하셔도 되고, 로그인 진행 및 투어 생성 후 씬/마커 생성 및 조정을 수행하신 후 가져오기를 진행하셔도 무방합니다.
5. 씬 이미지 캡처
Capture 360 파노라마 이미지 추출
•
콘텐츠 생성 및 배치가 완료되었다면 씬의 캡쳐를 진행할 차례입니다.
1.
XROO 플러그인 창의 Capture 탭으로 이동하여 캡쳐를 원하는 씬을 선택합니다.
2.
XROO 플러그인 창의 Capture 탭에 있는 Start를 클릭하여 생성한 씬의 이미지 캡쳐를 시작합니다.
Resolution은 360이미지 추출 시, 그 이미지들의 해상도를 의미합니다.
테스트로 진행해보시는 경우 “2048, 4096”으로 진행하여도 무방하나,
최종 결과물로 360이미지를 추출하고자 하는 경우, "8192"의 최고화질 이미지로 추출하는 것을 추천드립니다.
Quality는 360이미지 추출 시, 그 이미지들의 품질을 의미합니다.
Preview, Low, Middle, High의 각 4단계 프리셋으로 구성되어 있습니다.
High로 갈수록 이미지의 품질이 좋아지긴 하나, 이미지를 추출하는데 더 많은 시간이 소요됩니다.
XROO에서는 Low의 퀄리티로도 시간 대비 충분히 좋은 360이미지를 추출할 수 있으니, Low로 진행을 추천드립니다.
Save JPG의 체크가 되어 있는 경우, 캡쳐를 진행하는 테마 폴더에 360이미지가 JPG포맷으로 추출됩니다.
XROO에서는 씬 이미지는 JPG의 확장자의 업로드를 지원하므로 해당 체크박스가 체크된 상태로 진행하세요.
•
캡쳐한 이미지는 default로 설정된 경로에 자동 저장되며, 진행과정은 작업중인 레벨 화면 좌측 상단에서 확인할 수 있습니다.
"이미지 캡쳐가 완료되었습니다." 팝업을 통해 캡쳐가 완료되었음을 확인할 수 있습니다.
6. 내보내기
데이터 내보내기
위 팝업을 확인하신 후 데이터를 전송하세요.
•
투어 정보 업데이트
1.
먼저 투어 데이터를 업데이트합니다.
투어 데이터를 먼저 업데이트해주셔야 Image file, 3D model의 정보 업데이트가 가능합니다.2. 해당 레벨의 각 씬 캡쳐 이미지를 업로드합니다.
캡쳐 이미지를 업데이트할 Theme를 체크하고 캡쳐 이미지 파일이 저장된 폴더를 선택합니다.
경로를 선택 후, Upload를 클릭하여 이미지를 업로드할 준비를 해주세요.
추후 전송 진행 시, 남은 업로드 이미지 개수는 버튼 상단에서 확인할 수 있습니다.
•
이미지 업로드가 완료되면 "이미지 데이터 업데이트가 완료되었습니다." 팝업을 확인할 수 있습니다.
모델링 데이터 내보내기
•
해당 레벨의 모델링 데이터를 업로드합니다.
모델링 파일은 OBJ 파일 형식으로 저장되어야 합니다.•
Attach 버튼을 클릭하여, 저장한 모델링 obj파일을 선택하여 업데이트합니다.
•
모델 데이터 업로드가 완료된 경우, 위와 같이 "모델 데이터 업로드가 완료되었습니다." 팝업을 확인할 수 있습니다.
7. XROO 사용자 환경
XROO 홈페이지에서 투어 & 작업 내역 확인
•
XROO 홈페이지에서 로그인하여 언리얼에서 작업한 내역을 확인해 보겠습니다.
•
언리얼에서 로그인한 계정과 동일한 계정으로 로그인해 주세요.
•
로그인이 완료되면 언리얼에서 생성, 작업한 투어를 투어 목록에서 확인할 수 있습니다.
•
해당 투어를 클릭하여 상세 내용을 확인해보겠습니다.
Import 탭에서 언리얼을 통해 생성한 씬이 확인됩니다.
Capture 진행한 업로드한 씬 이미지도 제대로 업로드되었음을 확인할 수 있습니다.
•
Edit 탭에서 언리얼을 통해 업로드한 3D 모델링이 키맵으로 제대로 표현되고 있음은 물론, 언리얼에서 작업한 콘텐츠 요소들이 제대로 노출되고 있음을 확인할 수 있습니다.
복수의 테마에 따른 개별 모델링 적용 안내
•
XROO 플러그인에서 XROO로 보내기를 클릭하면, 업데이트할 항목을 선택하여 전송할 수 있는 팝업이 등장합니다.
•
모델링 파일을 업로드할 수 있으며, 동일한 파일명을 업로드할 경우 기존 파일이 새로 업로드된 파일로 대치되오니 파일명을 확인하고 업로드를 진행해주세요.
•
업로드가 완료되면 하단 목록에 업로드한 파일명이 노출됩니다.
•
삭제하고자 하는 경우 우측 X버튼을 클릭하여 삭제하세요.
•
각 테마에 적절한 모델링 파일을 업로드하고 해당 파일을 모두 전송하거나 XROO에서 확인하고자 하는 파일을 체크 후, 전송을 클릭하여 XROO로 데이터를 전송하세요.
•
데이터 전송 완료 후, XROO에 로그인하여 Import 페이지 내 Set Theme 모달에서 업로드 된 모델링 파일을 각 테마에 맞게 매칭할 수 있습니다.