Version: 2017.3
Vuforia: 빠른 시작 가이드(Vuforia: Quick start guide)
이미지 타겟 설정

Vuforia용 프로젝트 설정

Vuforia AR 또는 MR 모바일 애플리케이션을 개발하기 위한 프로젝트 설정은 모바일 플랫폼용 Unity 빌드 설정 프로세스와 매우 비슷합니다. Unity 설치 프로그램에는 Vuforia SDK가 들어 있습니다. InstallingUnity 매뉴얼 페이지의 Unity 다운로드 및 설치 지침을 따르십시오. Vuforia는 씬에 놓을 수 있도록 디자인된 일련의 프리팹을 제공하여 애플리케이션에 기능을 추가합니다. 이러한 프리팹은 Unity 에디터 내에서 이용할 수 있습니다.

일반 모바일 게임의 개발에 요구되는 것과 동일한 성능 고려 사항을 준수해야 합니다. 모바일 기기 최적화에 대한 자세한 내용은 모바일 최적화에 대한 Unity 기술 자료를 참조하십시오.

Unity에서 Vuforia를 설정하는 방법은 다음과 같습니다.

  • 최신 Unity 버전을 설치하고 설치 프로그램의 Unity component selection 섹션에서 iOS Build Support 또는 Android Build Support 와 더불어 Vuforia Augmented Reality Support 를 선택합니다.
Unity 설치 프로그램을 통해 Vuforia 증강 현실 지원 설치
Unity 설치 프로그램을 통해 Vuforia 증강 현실 지원 설치

참고: 대부분의 AR 및 MR 애플리케이션은 모바일 기기를 타겟으로 하기 때문에 이 가이드는 Android 및 iOS 개발에 초점을 맞추고 있습니다. AndroidiOS에 대한 시작하기 문서의 안내에 따라 Android 및 iOS 기기에 대한 빌드 지원을 활성화하십시오.

  • Vuforia 등록 페이지에서 Vuforia 개발자 계정을 생성하십시오. 이 계정을 사용하면 Unity에서 Vuforia로 AR 및 MR 애플리케이션을 만드는 데 필요한 툴에 액세스할 수 있습니다.

  • Unity ID가 아직 없다면 Unity 등록 페이지에서 새로 생성하십시오. Unity 에셋 스토어에서 패키지를 다운로드하려면 Unity ID가 필요합니다.

  • Unity를 열고 새 3D 프로젝트를 생성합니다. 이때 Add Asset Package 버튼 옆의 3D 옵션을 선택해야 합니다. 프로젝트 이름을 지정하고 Create project 버튼을 클릭합니다.

새 3D 프로젝트 생성
새 3D 프로젝트 생성

팁: Unity 에셋 스토어에서 Vuforia AR+VR 예제 패키지를 다운로드하십시오. 이 패키지에는 주요 기능을 보여주는 유용한 예제 씬이 포함되어 있습니다. 이 가이드에서 이 예제 패키지는 필요하지 않지만, 향후 심화 학습을 위해 받아두면 도움이 될 것입니다.

Unity에서 Vuforia 활성화

Unity 프로젝트에서 Vuforia를 활성화하려면 Edit > Project Settings > Player 에서 Player Settings에 액세스한 후 빌드하려는 모바일 기기의 탭을 선택합니다. XR Settings 에서 Vuforia Augmented Reality Support 체크박스를 선택합니다.

Unity Player Settings에서 Vuforia 증강 현실 지원 활성화
Unity Player Settings에서 Vuforia 증강 현실 지원 활성화

현재 씬에는 두 개의 게임 오브젝트, 즉 메인 카메라와 방향 광원이 포함되어 있습니다. AR 기능을 활성화하려면 새 AR 카메라를 추가하고 씬에서 기존의 Main Camera 게임 오브젝트를 삭제해야 합니다.

카메라 게임 오브젝트를 삭제하려면 Hierarchy 창 에서 해당 카메라 게임 오브젝트를 선택한 후 키보드의 Delete 키를 누르거나, 마우스 오른쪽 버튼을 클릭한 후 Delete 를 선택합니다.

XR Settings 창의 개별 설정에 대한 자세한 내용은 이 매뉴얼의 Vuforia 플랫폼 설정 페이지를 참조하십시오.

Vuforia AR 카메라 및 기타 게임 오브젝트 추가

AR 카메라를 씬에 추가하려면 GameObject > Vuforia > AR Camera 로 이동합니다.

씬에 Vuforia 게임 오브젝트를 처음으로 추가하는 경우 Unity에 Vuforia 에셋을 임포트하라는 메시지가 표시됩니다. Import 를 선택하면 Unity가 모든 필요한 Vuforia 파일을 프로젝트로 임포트합니다.

Project 창 에는 4개의 새 폴더가 표시되며, 그중 하나가 Vuforia 입니다. 이 폴더의 코드와 에셋은 메인 AR 및 MR 기능을 제공합니다. 다른 폴더는 다양한 기기용 AR 및 MR 애플리케이션을 개발할 수 있도록 지원하는 예제 씬, 리소스, 툴, 플러그인을 제공합니다.

빈 프로젝트와 모든 임포트된 Vuforia 에셋
빈 프로젝트와 모든 임포트된 Vuforia 에셋

프로젝트에서 새 폴더를 만듭니다. 이렇게 하려면 Project 창으로 이동한 후 Create 버튼을 클릭하고 Folder 를 선택합니다. 새 폴더에 Scenes 라는 이름을 지정한 후 이 폴더 내에 새 씬을 저장합니다.

빈 폴더를 만든 후 Scenes라는 이름 지정
빈 폴더를 만든 후 Scenes라는 이름 지정

또한 이 프로세스는 씬 계층 구조에 새 ARCamera 게임 오브젝트를 추가합니다.

Vuforia 라이선스 키 만들기

설정 프로세스의 마지막 단계는 Vuforia 개발자 포털의 라이선스 관리자 섹션에서 라이선스 키를 생성하는 것입니다. 이 키를 Unity의 Vuforia 구성 설정에 입력해야 Unity로 애플리케이션을 빌드하고 테스트할 수 있습니다.

Vuforia 개발자 포털로 이동한 후 로그인하거나 새 계정을 만듭니다. Develop 섹션의 License Manager 로 이동한 후 Get Development Key 버튼을 클릭하여 Add License Key 페이지를 엽니다.

Vuforia 개발 키 생성
Vuforia 개발 키 생성

Add License Key 페이지에서 앱 이름을 입력합니다. 그런 다음 약관을 수락하고 Confirm 버튼을 클릭하여 새 라이선스 키를 생성합니다.

Vuforia 개발 키 세부 사항 확인
Vuforia 개발 키 세부 사항 확인

다음 페이지에서 Vuforia 개발자 조항에 동의(상자 선택)한 후 Confirm 버튼을 클릭합니다. 그러면 License Manager 페이지로 다시 이동하여 새로 생성된 라이선스가 리스트에 Active 상태로 표시된 것을 볼 수 있습니다. 앱 이름을 클릭하여 라이선스 세부 사항을 확인합니다. 이를 통해 개발 라이선스 키를 가져올 수 있습니다.

라이선스 관리자
라이선스 관리자

라이선스 키를 클립보드에 복사한 후 Unity 프로젝트로 다시 돌아옵니다.

Vuforia 라이선스 키 복사
Vuforia 라이선스 키 복사

Hierarchy 창 에서 ARCamera 게임 오브젝트를 선택하고, Inspector 창에서 Vuforia Behaviour(Script) 컴포넌트로 이동한 후 Open Vuforia configuration 버튼을 클릭합니다.

Vuforia 구성 설정에 액세스
Vuforia 구성 설정에 액세스

Inspector 창Vuforia Configuration 옵션 리스트가 표시됩니다. Vuforia 섹션의 App License Key 텍스트 상자에 Vuforia 개발 키를 붙여넣고 Add License 버튼을 클릭합니다.

Vuforia 구성 설정에 Vuforia 개발 키 입력
Vuforia 구성 설정에 Vuforia 개발 키 입력

설정 테스트

Unity 에디터에서 Vuforia 앱을 테스트하려면 웹캠을 PC 또는 노트북에 연결해야 합니다. Vuforia가 Unity 프로젝트에 올바르게 설치되었는지 최종적으로 확인하기 위해 Play 버튼을 눌러 씬을 테스트합니다. Vuforia가 제대로 설정되었으면 웹캠의 비디오 피드가 에디터의 Game 뷰에 나타납니다.

이제 이미지 타겟을 설정하고 프로젝트에 AR 기능을 추가할 준비를 마쳤습니다.


  • 2018–03–28 편집 리뷰를 거쳐 페이지 게시됨

  • 2017.3 Unity XR API에서 Vuforia 문서 업데이트됨

Vuforia: 빠른 시작 가이드(Vuforia: Quick start guide)
이미지 타겟 설정