사용 예제로 빠르게 시작하는 EasyAR Unity 개발
이 튜토리얼은 AR 개발을 빠르게 시작하기 위해 EasyAR Unity 예제를 구성하고 실행하는 방법을 소개합니다.
빈 Unity 프로젝트 준비
호환 가능한 Unity 버전(Unity 2021.3 이상)이 설치되어 있는지 확인하고, 최신 버전인 Unity 2022.3 또는 Unity 6.3 사용을 권장합니다.
3D (Built-in Render Pipeline) 템플릿을 사용하여 빈 Unity 프로젝트를 생성합니다:
참고
처음 사용 시에는 URP를 권장하지 않습니다.
Unity 6를 사용 중이라면, 3D (Built-In Render Pipeline) Template을 수동으로 다운로드하여 사용해야 하며, 기본 설치 시 템플릿 목록 하단에 위치합니다.
중요
URP를 사용하려면 Universal Render Pipeline (URP)에 설명된 추가 구성이 반드시 필요하며, 그렇지 않으면 카메라 화면이 표시되지 않습니다.
EasyAR Sense Unity Plugin 가져오기
- 플러그인 패키지 다운로드
- 최신 버전의 EasyAR Sense Unity Plugin을 다운로드하세요. 이 패키지에는 샘플이 포함되어 있습니다.
- 다운로드한
zip파일의 압축을 해제하면readme파일과.tgz파일을 확인할 수 있습니다..tgz파일은 Unity로 직접 가져올 수 있으며, 압축 해제하면 안 됩니다. .tgz파일을 Unity 프로젝트의Packages폴더 내에 저장하세요.
- 플러그인 패키지 가져오기
- 메뉴 바에서
Window를 클릭한 후Package Manager를 선택하세요. - 나타나는 창의 왼쪽 상단에 있는
+기호를 클릭하고,Install Package from tarball ...을 선택하세요. - 표시되는 대화 상자에서 앞서 준비한
.tgz파일을 선택하세요.
- 메뉴 바에서
참고
.tgz 파일은 Unity로 가져온 후에는 삭제하거나 다른 위치로 이동할 수 없습니다. 가져오기 전에 이 파일을 적절한 위치(일반적으로 버전 관리를 위해 Unity 프로젝트의 Packages 폴더 내)에 미리 배치해야 합니다.
가져오기 샘플
메뉴 Window > Package Manager를 열어 Package Manager를 엽니다. EasyAR Sense Unity Plugin을 선택하면 오른쪽에 **모든 샘플**을 선택하여 한번에 모든 샘플을 가져옵니다.
주의
**모든 샘플**과 다른 샘플을 동시에 가져올 수 없습니다. 그렇지 않으면 중복된 에셋이 발생하여 일부 씬 에셋이 손실될 수 있습니다. 실수로 중복 파일을 가져온 경우 삭제 후 다시 가져와야 합니다.
수정 장면 목록
Build Settings (또는 Build Profiles)를 엽니다.
Unity 프로젝트의 샘플 장면을 Build Settings 또는 Build Profiles의 Scene List에 추가하고, 샘플 런처 장면(AllSamplesLauncher)을 모든 장면 중 첫 번째로 이동시킵니다.
주의
다음 헤드셋 기반 장면들은 추가하지 않도록 주의하세요. 그렇지 않으면 패키징이 실패할 수 있습니다:
- Combination_BasedOn_AppleVisionPro.rst
- Combination_BasedOn_Xreal.rst
라이선스 키 입력
Unity 메뉴에서 EasyAR > Sense > Configuration을 선택하여 EasyAR Sense 설정 인터페이스를 불러옵니다.
EasyAR Sense License 아래 입력란에 EasyAR Sense License를 입력하세요.
팁
EasyAR Sense License는 EasyAR 개발 센터(중문, 영문)에서 생성할 수 있습니다. 처음 사용하는 경우 다음 단계에 따라 생성하세요:
EasyAR Sense 4.x 개인판생성- sparse spatial map은
예를 선택하고, 이름은 자유롭게 입력 - 앱 이름은 자유롭게 입력, Bundle ID와 Package Name에는
com.mycompany.myproject입력 - 생성된 License를 선택한 후, 오른쪽 복사 버튼 클릭
참고
Bundle ID와 Package Name은 나중에 변경할 수 있지만 횟수에 제한이 있습니다. 명확한 애플리케이션 패키지명이 있다면 직접 입력해도 됩니다.
개인판 생성에는 개수 제한이 없으며, 다른 유형은 실제 사용 시 필요에 따라 생성할 수 있습니다.
Running in the editor
편집기에서 실행하려면 컴퓨터에 카메라가 연결되어 있어야 합니다.
시스템 카메라 확인
시스템 카메라 앱 열기:
카메라가 정상 작동하는지 확인:
예제 실행 시 충돌이 발생하지 않도록 카메라 앱을 반드시 닫으세요.
참고
EasyAR은 시스템 제공 인터페이스만으로 카메라를 열기 때문에, 시스템 카메라 앱이 카메라를 열고 정상적으로 표시할 수 있어야 합니다.
실행 예제
다음 내용은 이미지 추적 예제
ImageTracking_Targets를 기준으로 하며, 다른 예제도 유사한 방식으로 실행됩니다.
예제 런처 씬을 열고 Unity 에디터 상단의 Play 버튼을 클릭하세요.
ImageTracking_Targets 씬으로 진입합니다.
팁
ImageTracking_Targets 씬을 직접 열어 실행할 수도 있습니다.
카메라를 아래 인식 대상에对准하세요:
다운로드: 🔗 namecard
EasyAR이 이미지를 인식하여 가상 객체를 오버레이합니다.
참고
일부 기능은 에디터에서 카메라 연결 실행이 불가능하지만 모바일에서는 작동합니다. 에디터에서 사용할 수 없는 예제는 시작 실패 팝업이 표시됩니다.
동시에 메시지 알림과 오류 로그가 출력됩니다.
모바일에서 실행
모바일에서 실행하려면 패키징이 필요합니다. 패키징 전에 Player 구성을 수정해야 합니다.
플레이어 설정 수정
Unity 메뉴 File > Build Settings > Player Settings에서 순서대로, Android 아이콘을 클릭하여 Android 플랫폼에 해당하는 설정을 불러옵니다.
Package Name을 License Key 페이지에 표시된 Package Name으로 수정합니다.
팁
예를 들어, License Key 생성 시 입력한 Package Name이
com.mycompany.myproject인 경우, 여기 Package Name을 반드시com.mycompany.myproject로 입력해야 합니다. 그렇지 않으면 실행에 실패합니다.Minimum API Level을
API Level 21이상으로 수정합니다.
Scripting Backend을
IL2CPP로 수정하고,Target Architecture에서ARM64를 선택합니다.
앱 패키징
File > Build Settings 선택 후 대상 플랫폼(Android/iOS)을 지정하고 switch platform을 선택합니다.
Build 또는 Build And Run을 선택하여 프로젝트를 빌드하고 모바일 기기에 설치합니다. 실행 시 해당 권한을 허용해야 합니다.
실행 예제
다음 내용은 이미지 추적 예제
ImageTracking_Targets를 기준으로 합니다. 다른 예제도 동일한 방식으로 실행할 수 있습니다.
실행 후 시작되는 것은 샘플 런처 씬입니다.
팁
시작 시 샘플 런처 씬으로 진입하지 않는다면, Build Settings 또는 Build Profiles의 씬 목록에서 AllSamplesLauncher가 첫 번째로 설정되었는지 확인하세요.
ImageTracking_Targets 씬으로 진입합니다.
휴대폰 카메라를 아래 인식 이미지에 맞춥니다:
다운로드 링크: 🔗 namecard
EasyAR는 이 이미지를 인식 및 추적하고 가상 오브젝트를 오버레이합니다.
다음 단계
Unity AR 샘플을 성공적으로 실행했으므로, 이 샘플이 보여주는 AR 장면이 어떻게 생성되었는지 궁금하실 수 있습니다. 다음 입문 가이드를 순서대로 읽어보세요:
샘플 런처에 대한 자세한 사용 설명은 다음을 참고하세요:
전체 프로젝트 설정을 이해하려면 다음 내용을 참고하세요:
EasyAR 사용법을 더 깊이 이해하고 싶다면 여기서 시작하세요: