EasyAR Mega Unity 개발을 위한 빠른 시작 가이드: 예제 활용
이 튜토리얼은 EasyAR Mega Unity 예제를 구성하고 실행하여 EasyAR Mega 개발을 빠르게 시작하는 방법을 설명합니다.
시작하기 전에
이 문서를 읽기 전에 다음 사항을 완료했는지 확인하세요:
- 유효한 클라우드 기반 위치 라이브러리가 있습니다.
- Unity(2021.3.30 LTS 이상)가 설치되어 있어야 하며, 최신 버전인 Unity 2022.3 또는 Unity 6.3 사용을 권장합니다.
- Mega 활성화 방법에 따라
com.easyar.sense-**.tgz및com.easyar.mega-**.tgz패키지를 가져왔습니다.
예제 사용 방법（여섯 단계）
아래에서는 EasyAR Mega의 핵심 예제인 MegaBlock_Basic을 구성하고 실행하는 방법을 여섯 단계로 나누어 설명합니다.
첫 번째 단계: 샘플 가져오기
[!참고]
**모든 샘플**을 통해 전체 예제를 가져온 경우 이 단계를 건너뛰어야 합니다.
Window>Package Manager메뉴를 사용하여 Package Manager를 엽니다.EasyAR Sense Unity Plugin을 선택하고, 오른쪽의 샘플에서 모든 예제를 펼칩니다.- 샘플(예:
MegaBlock_Basic)을 선택하고 가져오기를 클릭합니다.
[!참고]
- 이 튜토리얼은 HMD 기기에 직접 적용할 수 없으나, HMD 기기 개발 전에 휴대폰 개발을 통해 워크플로우를 이해해야 합니다.
- 이전 버전 SDK의 샘플을 이미 가져온 적이 있다면, SDK 업그레이드 후 기존 샘플을 먼저 삭제하고 다시 가져와야 합니다.
두 번째 단계: 라이선스 키 입력 및 메가 클라우드 위치 서비스 설정
- 메뉴 바에서
EasyAR>Sense>Configuration선택;
- 열린 Project Settings 패널에 라이선스 키 붙여넣기;
팁
EasyAR Sense 라이선스는 EasyAR 개발센터에서 생성 가능. 초기 사용 시 다음 단계로 생성:
EasyAR Sense 4.x 개인판생성- 희소 공간 지도 선택
아니오 - 앱 이름 자유 기입, Bundle ID 및 Package Name에
com.mycompany.myproject입력 - 생성된 라이선스 선택 후 우측 복사 버튼 클릭
참고
Bundle ID와 Package Name은 이후 변경 가능하나 횟수 제한 있음. 명확한 애플리케이션 패키지명이 있을 경우 본인 패키지명 사용 권장.
개인판 생성 개수 제한 없음, 기타 유형은 실제 사용 시 필요에 따라 생성.
- Project Settings 패널의
Mega Block항목에 메가 클라우드 위치 라이브러리 정보 입력;
팁
메가 클라우드 위치 라이브러리 설정은 EasyAR 개발센터에서 획득 가능.
API Key에 Mega Block 권한 있는지 반드시 확인, 없을 경우 수정 또는 재생성 필요.
세 번째 단계: 3d 콘텐츠 배치
Hierachy패널의 빈 공간에서 마우스 오른쪽 버튼으로 클릭하여 Block 뷰어 도구(Unity 개발)를 추가합니다.
Mega 위치 서비스에 액세스합니다.
EasyAR.Mega.BlockViewer (Dev)노드를 선택하고, Inspector 패널에서 EasyAR 계정 정보를 입력하여 로그인합니다.
- Mega Cloud Service 오른쪽 버튼을 클릭합니다.
- 사용할
Mega 위치 서비스를 선택하고 확인을 클릭합니다.
Block 로드
서비스를 선택한 후, 현재 라이브러리의 Block 목록이
MegaBlocks노드 아래와 도구 패널에 표시됩니다. 로드를 클릭하여 선택한 Block을 로드합니다:
로드가 완료되면 Block이
Scene창에 표시됩니다.Scene창에서 작업하여 시야각과 위치를 조정하고 확인할 수 있습니다. 동시에 Block 파일이 사용 가능한지 확인합니다(예: Block 좌표계가 정상인지, 레이어가 존재하는지, 너무 흐리거나 손상되어 AR 리소스를 배치할 위치를 찾을 수 없는지 등).
3d 콘텐츠 배치
이제 Block을 참조하여 3D 오브젝트를 배치할 수 있습니다.
참고
- 런타임에 가상 콘텐츠의 렌더링 위치가 정확하도록 3D 오브젝트는 도구가 자동으로 생성한
MegaBlocks>Block_*노드 아래에 배치해야 합니다. Block_*노드의 이름과local transform은 도구가 자동으로 관리하므로 수정하지 마십시오.
- 런타임에 가상 콘텐츠의 렌더링 위치가 정확하도록 3D 오브젝트는 도구가 자동으로 생성한
Step 4: MegaTracker 구성
Block Root 구성하기;
AR Session을 확장하고,Mega Block Tracker를 선택한 후Block Root를 도구에서 생성된MegaBlocks노드로 설정합니다.
다섯 번째 단계: player 구성 수정
Unity 메뉴 File > Build Settings > Player Settings에서 Android 아이콘을 클릭하여 Android 플랫폼 설정을 엽니다.
Package Name을 라이선스 키 페이지에 표시된 Package Name으로 수정
팁
예를 들어, 라이선스 키 생성 시 Package Name이
com.mycompany.myproject인 경우, 여기에 반드시 동일한com.mycompany.myproject를 입력해야 합니다. 그렇지 않으면 실행이 실패합니다.Minimum API Level을
API Level 21이상으로 수정
Scripting Backend를
IL2CPP로 변경하고,Target Architecture에서ARM64선택
Step 6: 빌드 및 실행
- 현재 씬을
File>Build Settings또는Build Profiles>Scene List에 추가합니다; - 대상 플랫폼(예: Android / iOS)으로 전환하고, 패키지명(Bundle ID)과 라이선스 키(License Key)가 일치하는지 확인합니다;
- Build And Run을 클릭합니다.
실제 촬영한 실행 효과는 다음과 같습니다:
화면의 노란색 텍스트에 대하여
런타임 시 화면에 두 곳의 노란색 텍스트가 표시될 수 있습니다.
시뮬레이션 실행 경고 메시지
화면 하단에 위치합니다:
이 경고는 기본 설정에서 애플리케이션이 현장에서 실행되지 않아도 되기 때문에 나타납니다. 이는 애플리케이션 실행에 약간의 영향을 미칩니다. 현장에서 사용 중이라면, 패키징 전에 MegaTracker 설정 수정을 고려해 보세요.
진단 정보
화면 상단에 위치하며, 세션의 실행 상태와 문제를 파악하는 데 사용됩니다. 개발 및 테스트 단계에서 표시를 유지하는 것이 좋습니다:
이러한 진단 정보의 구성 및 사용법을 빠르게 이해하려면 씬 내 진단 정보를 참조하세요.
다음 단계: 입문에서 숙련까지
축하합니다! 위 단계를 통해 10분 이내에 EasyAR Mega의 핵심 샘플을 성공적으로 실행하여, 공간 위치 인식과 AR 콘텐츠 오버레이의 매력을 직접 체험하셨습니다.
이제 기초를 다지셨습니다. 만약 다음과 같은 것을 원하신다면:
- 더 안정적이고 효율적인 AR 애플리케이션 구축
- 복잡한 실-가상 오클루전, 콘텐츠 정렬 등의 효과 구현
- 장비가 없거나 현장에 방문할 수 없을 때 디버깅 수행
아래의 심화 가이드를 참고하세요. 이 가이드들은 개발 과정에서 마주치는 실제 문제를 해결하는 데 도움을 줄 것입니다.
개발 고급
전체 엔지니어링 설정을 이해하고 싶다면 다음 내용을 참고하세요:
EasyAR 사용 방법을 더 깊이 이해하고 싶다면 여기서 시작하세요:
동시에 개발 및 디버깅에 도움이 되도록 다음 내용을 읽는 것을 권장합니다:
Fine-grained control of mega features
아래 내용은 앱에서 Mega를 더 잘 활용하는 데 도움을 줍니다:
아래 내용은 현장에 방문하지 않고도 Mega 기능을 검증하는 데 도움을 줍니다:
고급 주제
아래 내용들은 EasyAR 사용 경험이 어느 정도 있는 분들에게 더 적합합니다.
헤드셋에서 EasyAR Mega를 실행하고 싶다면 다음 내용을 참고하세요:
AR Foundation을 사용하고 싶다면 여기서 시작하세요: