21
MaxstAR SDK 2.0 for Unity3D Manual Ver 1.2 2015. 05. 14.

MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

Embed Size (px)

Citation preview

Page 1: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

MaxstAR SDK 2.0 for Unity3D Manual

Ver 1.2

2015. 05. 14.

Page 2: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

○ 목 차

1. 사전 요구사항 및 제약사항 …………………………………… 1

2. Trackable Data 생성 …………………………………… 2

(1) 페이지 접속 및 회원가입 …………………………………… 2

(2) Trackable Data 생성 및 추가/삭제 …………………………………… 5

(3) Unity3D 4.6.x 다운로드 및 설치 …………………………………… 11

3. Maxst AR SDK Unity3D Package 다운로드 …………………………………… 11

4. Unity 3D 프로젝트 생성 및 기본설정 …………………………………… 12

5. 물체 증강 …………………………………… 15

6. 참고 …………………………………… 19

Page 3: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 1 -

○ 사전 요구사항 및 제약사항 ▷ Window / MacOS / Android OS / iOS 환경에서 사용 가능 (2015. 05. 14 기준) ▷ Unity 3D 4.6.x 이상 지원 ▷ 모바일 환경 내의 가로(Landscape view)만 지원 (2015. 04. 06 기준) ▷ 워터마크

Version Lite Pro

표시유무 O X

※ Pro 버전의 구매를 원하시는 분은 아래의 MAXST SDK팀 이메일로 문의 E-mail : [email protected] ※ 본 매뉴얼은 Window 7 기반에서 작성되었으며, Mac에서 진행시 메뉴 구성이 다를 수 있습니다.

Page 4: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 2 -

○ Trackable Data 생성 ▷ 웹페이지를 이용하여 Trackable Data 생성 가능 - 아래의 웹페이지 이용시 회원 계정 필요(계정이 없을시 가입 필수) - https://arplatform.maxst.com/ ▷ 페이지 접속 및 처음화면

▷ 회원 가입 - 로그인 버튼 아래의 “Join”을 클릭하여 회원 가입 가능

Page 5: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 3 -

- 가입정보 입력 • 이용약관 및 개인정보취급방칙 동의

• Register에서 ID(E-mail), 비밀번호 입력 후 “REGISTER” 클릭

Page 6: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 4 -

• 정보 입력 후 “REGISTER” 클릭 후 확인 메일 발송

- 회원가입 메일 확인 • ID로 이용한 메일에 접속하여 “MAXST AR SDK - 계정인증” 메일 확인 • "MAXST AR SDK 시작하기“ 링크 접속

- 회원 가입 완료 • “MAXST AR SDK 시작하기” 링크 접속시 회원가입 완료

Page 7: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 5 -

▷ Trackable Data 생성 및 추가 / 제거 - ID/Password 입력하여 로그인

- 로그인 성공 후 시작페이지

Page 8: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 6 -

- Trackable 그룹 생성 • 페이지 상단의 "Trackable 그룹 생성“ 클릭

- 그룹 생성 페이지 • 그룹이름 입력 후 “OK" 클릭하여 그룹 생성

- Trackable 이미지 업로드 • 그룹 생성 후 생성된 “그룹명” 클릭

Page 9: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 7 -

- Trackable 이미지 등록 • Trackable 이미지를 등록하기 위하여 오른쪽 상단의 "Trackable 추가“ 버튼 클릭

• Trackable 생성 페이지 내의 세부 항목 작성 • "Trackable Name" 입력 후 “Upload"를 클릭하여 이미지 추가 후 "OK" 버튼 클릭

Page 10: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 8 -

• “학습이 진행중입니다.” 문구 출력시 문구 아래의 “새로 고침” 클릭

• 업로드한 이미지가 표시되면 Trackable Data 생성 완료

Page 11: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 9 -

※ 위의 과정 반복하여 여러 개의 Trackable Data 생성 가능

※ 이미지 아래의 수정/삭제를 이용하여 Data 수정 / 삭제 가능

- Trackable 다운로드 • Trackable 이미지 왼쪽 상단의 체크 버튼을 이용하여 Trackable Data 선택

Page 12: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 10 -

• “선택한 Trackable 다운로드” 버튼 클릭

• Trackable이 Packaging되어 다운로드 진행

Page 13: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 11 -

○ Unity3D 4.6.x 버전 다운로드 및 설치 ▷ Unity 3D 다운로드 페이지 - http://unity3d.com/unity/download/archive - 아래 화면과 같은 Unity3D Archive에서 Unity 버전과 OS에 맞게 다운로드 및 설치

○ Maxst AR SDK Unity3D Package 다운로드 ▷ 다운로드 페이지 - http://maxst.com/products

Page 14: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 12 -

○ Unity 3D 프로젝트 생성 및 기본설정 ▷ 프로젝트 생성 - Unity3D 아이콘을 클릭하여 Unity3D 실행 - ProjectWizard 화면 생성시 • Create New Project Tab 선택 • Browse에서 경로 지정 • Create 클릭 프로젝트 생성

- ProjectWizard 화면 미생성시 • Unity3D 메인화면에서 상단 메뉴인 File → New Project를 클릭 • Project Wizard 창 로드

▷ 메인 카메라 삭제 - Unity3D 메인페이지의 Hierarchy Tab의 기본 Main Camera를 선택 - Delete키를 이용하여 Main Camera 삭제

Page 15: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 13 -

▷ MaxstAR SDK Package 설정 - Unity3D 메인 화면에서 상단 메뉴인 Asset → Import Package → Custom Package 클릭

- 다운받은 MaxstARSDK.unityPackage를 선택 후 열기

- Importing Package 화면에서 왼쪽 체크박스가 모두 체크되어 있는지 확인하고 Import 버튼 클릭

Page 16: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 14 -

- Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지 확인

▷ AR Camera 출력 확인 - PC에 Webcam 연결 - Project Camera 설정 • Unity3D 메인 화면에서 Project Tab의 Assets → MaxstAR 선택 • Prefabsdml ARCamera를 Hierarchy Tab으로 드래그앤드랍

- 카메라 확인 • Unity3D 메인 페이지의 중앙에 위치한 Play 버튼을 클릭하여 프로젝트 실행 • Game Tab에서 Web Camera가 정상적으로 보이는지 확인

Page 17: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 15 -

▷ 물체 증강 - Trackable Package 추가 설정 • Unity3D 메인 화면에서 상단 메뉴인 Asset → Import Package → CustomPackage 클릭

• 다운받은 Samples.unityPackage를 선택 후 열기 • Importing Package의 체크박스를 확인 후 Import 클릭

- 증강물체 생성 • Project Tab에서 Assets → MaxstAR을 선택 • Prefabs에서 TrackableTarget을 드래그앤드랍하여 Hierachy Tab으로 이동

Page 18: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 16 -

• Hierarchy Tab의 TrackableTarget을 선택 후 Inspector Tab의 Trackable Behavior영역에서 Group Name을 다운받은 Trackable Group으로 선택하고, Trackable Name을 Tracking을 수행할 이미지 선택

- Trackable과 증강 물체 연결 • 상단 메뉴의 GameObject → Create Other → Cube 선택

Page 19: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 17 -

• Hierarchy Tab에서 생성된 물체(Cube) 클릭 후 TrackableTarget로 드래그 앤 드랍 하여 TrackableTarget의 하위 노드가 되도록 수행

- 증강 물체 설정 • Hierarchy Tab에서 증강 물체(Ex> Cube 등)을 선택 후 Inspector Tab의 Transform (Scale, Position, Rotation) 값을 조절하여 객체의 이동, 회전, 크기변환 설정 • Ex> Transform Position Y : 0.3, Scale X: 0.3, Y: 0.3, Z: 0.3으로 설정

Page 20: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 18 -

- 카메라 테스트 • Unity3D 중앙 상단의 플레이 버튼을 클릭하여 카메라 출력 확인

• 테스트 결과 확인

Page 21: MaxstAR SDK 2.0 for Unity3D Manual · 2015-05-14 · - 14 - - Unity3D 메인 페이지의 Project Tab에서 Assets를 클릭 후 안의 내용이 다음과 같이 Import 되었는지

- 19 -

○ 참 고 ▷ Trackable Data 이미지 저장 위치 - [Unity Project 디렉토리]/Assets/Editor/MaxstAR/Textures/[Trackable 그룹 이름]

▷ Game 화면 내의 물체 표면을 알아보기 어려울 경우 Lighting 추가 방법 - 왼쪽 화면과 같이 물체의 색상 정보를 알아보기 힘들 경우 메인 메뉴의GameObject → Create Other → Directional Light 을 추가하면 오른쪽 그림과 같이 명암이 적용된 증강 객체를 볼 수 있음

▷ Unity3D 5.0 이상 버전 사용시 주의점 - Android에서 빌드시 “중복된 dll 이름”의 에러 발생 - Plugins내의 x86 혹은 x86_64 중의 하나를 임시적으로 삭제 필요