Setup Guide

기본 개발 환경 설정
유니티용 MAXST AR SDK 설치
샘플 앱 실행 (유니티 에디터)
샘플 앱 빌드 (안드로이드)
샘플 앱 빌드 (iOS)

기본 개발 환경 설정

요구사항

  • MAXST AR SDK는 Unity 5.6 이상을 권장합니다.

  • 유니티용 MAXST AR SDK를 사용하기 위해서는 유니티 개발 도구와 유니티 개발에 대한 기본적인 지식이 필요합니다.

  • 유니티 개발 도구에 대한 자세한 정보는 유니티 웹사이트를 이용하시기 바랍니다.

유니티용 MAXST AR SDK 설치

  1. Unity MAXST AR SDK 다운로드

  2. 유니티 프로젝트를 열거나 새로 생성하세요.

    ※ 윈도우에서 유니티를 실행할 경우 -force-opengl 옵션을 주어야 합니다.

    1. 유니티 아이콘을 우클릭한 후, 속성을 선택하세요. setUpOpenGL

    2. 속성창의 실행 파일 경로에 -force-opengl을 추가하세요. setUpOpenGLPref

    3. 유니티 실행시 사용된 그래픽 라이브러리는 에디터 상단에서 확인할 수 있습니다. setUpEditorApi

  3. 다운 받은 유니티용 MAXST AR SDK Package를 더블 클릭하거나, 유니티 에디터 메뉴의 Assets / Import Package / Custom Package를 선택한 후 다운 받은 Package를 선택하여, 유니티용 MAXST AR SDK를 Import 하세요.

샘플 앱 실행 (유니티 에디터)

유니티용 MAXST AR SDK 샘플 앱을 실행하기 위해서는 다음 과정을 따라하세요.

  1. 유니티용 MAXST AR SDK를 설치하세요.

  2. 유니티 에디터에서 File > Build Settings을 선택하세요.

  3. Project View에서 Assets > MaxsARSamples > Scenes 폴더의 씬들을 Build Settings > Scenes In Build에 추가하세요.

    setUpAddScene

  4. Project View에서 Assets > MaxsARSamples > Scenes 폴더의 Home 씬을 더블 클릭 하세요.

  5. Toolbar의 Play 버튼을 눌러 실행하세요.

    setUpToolBar

    ※ Tracker 씬들에서 Home 씬으로 이동은 esc 키로 가능합니다.

샘플 앱 빌드 (안드로이드)

유니티용 MAXST AR SDK 샘플 앱을 빌드하기 위해서는 다음 과정을 따라하세요.

  1. 유니티용 MAXST AR SDK를 설치하세요.

  2. 유니티 에디터에서 File > Build Settings를 선택하세요.

  3. Project View에서 Assets > MaxsARSamples > Scenes 폴더의 씬들을 추가하세요.

    setUpAddScene

  4. Home 씬을 최상단에 위치시키세요.

    setUpHomeScene

  5. Platform 창에서 Android를 선택한 후 Switch Platform 버튼을 클릭합니다.

    setUpSwitchPlatform

  6. Platform 창에서 Player Settings 버튼을 클릭합니다.

    setUpPlayerSet

  7. Inspector 창에서 Auto Graphics API의 체크를 해제한 후, OpenGLES2를 최상위로 올립니다.

    setUpGraphicAPI

  8. Inspector 창에서 Package Name을 입력합니다.

    setUpOtherSet

  9. 라이선스 키를 입력합니다.

  10. 디바이스를 연결한 후, File > Build & Run을 선택합니다.

    ※ 안드로이드 SDK가 정상적으로 설정되어 있지 않은 경우, Select Android SDK root folder 메시지의 파일 선택창이 뜰 수 있습니다. 이 경우 유니티 에디터 메뉴바에서 Edit > Preferences를 선택하여 Android SDK 경로를 설정하면 됩니다.

    setUpPref

샘플 앱 빌드 (iOS)

유니티용 MAXST AR SDK 샘플 앱을 빌드하기 위해서는 다음 과정을 따라하세요.

  1. 유니티용 MAXST AR SDK를 설치하세요.

  2. 유니티 에디터에서 File > Build Settings를 선택하세요.

  3. Project View에서 Assets > MaxsARSamples > Scenes 폴더의 씬들을 추가하세요.

    setUpAddSceneiOS

  4. Home 씬을 최상단에 위치시키세요.

    setUpHomeSceneiOS

  5. Platform 창에서 iOS를 선택한 후 Switch Platform 버튼을 클릭합니다.

    setUpSwitchPlatformiOS

  6. Platform 창에서 Player Settings 버튼을 클릭합니다.

    setUpPlayerSetiOS

  7. Inspector 창에서 Auto Graphics API의 체크를 해제한 후, OpenGLES2를 최상위로 올립니다.

    setUpGraphicAPIiOS

  8. Inspector 창에서 Target minimum iOS Version을 8.0으로, Camera Usage Description에 문구를 넣습니다.

    setUpiOS

  9. Inspector 창에서 Bundle Identifier를 입력합니다.

    setUpOtherSetiOS

  10. 라이선스 키를 입력합니다.

  11. File > Build를 선택합니다.

  12. 생성된 xcode project 파일을 실행합니다.

    setUpiOSBuild

  13. 테스트폰 연결 / Signing 설정을 한 뒤 빌드합니다.

    setUpiOSSign