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