EasyAR Mega Annotation 형식 소개

EasyAR Mega Annotation(EMA)은 공간 annotation 데이터를 교환하기 위한 데이터 형식입니다. 파일은 일반적으로 .ema 확장자를 사용합니다. EMA 문서는 참조된 Mega Block과 annotation 사이의 관계, 그리고 애플리케이션이나 제3자가 정의한 확장 데이터를 설명할 수 있습니다.

사용 시나리오

EMA 형식은 일반적으로 다음 시나리오에서 사용됩니다:

• Mini Program 개발을 위해 현실 세계와 정밀하게 정렬된 3D 콘텐츠를 만드는 기능을 제공하며, WeChat이 block mesh를 참조해 콘텐츠를 배치하고 미리 볼 수 있는 editor를 제공하지 않는 문제를 해결합니다.
• AR 내비게이션 솔루션과 같은 내비게이션 시나리오를 위해 app과 Mini Program 전반의 내비게이션 기능에 통합 내비게이션 지점 그래프 데이터를 제공합니다.
• Mega Toolbox를 사용하여 annotation 모델을 통해 효과를 미리 보기합니다.

참고

애플리케이션이 Unity에서만 실행되는 경우 일반적으로 EMA 형식 데이터가 필요하지 않습니다. Unity 자체의 scene 및 serialization 기능만으로 관련 기능을 구현할 수 있습니다.

생성 및 저장

Mega Studio는 EMA 데이터를 생성하고 편집할 수 있으며 다음 기능을 지원합니다:

• 3D scene에서 annotation 데이터를 시각적으로 편집합니다.
• EMA 문서를 가져오기/내보내기합니다.
• Mega localization database에 연결하고 EMA 문서를 업로드/다운로드합니다.

EMA 문서는 독립 파일로 로컬에 저장하거나 Mega localization database에 저장할 수 있습니다. localization database의 각 EMA 문서 크기는 4 MB로 제한됩니다.

읽기 및 사용

EMA 문서는 여러 플랫폼에서 읽고 사용할 수 있습니다.

• Unity
• Mini Program

• 데이터 API
• EmaDecoder.Decode를 사용해 EMA 문서를 디코딩합니다
• Unity는 현재 서비스에서 EMA 문서를 로드하는 인터페이스를 제공하지 않습니다

사용법은 MegaBlock_Ema 샘플을 참조하십시오.

형식 버전

EMA 문서는 루트 객체의 version 필드를 통해 형식 버전을 선언합니다.

버전	형식 정의
0.5	EasyAR Mega Annotation 형식 0.5