Обзор формата EasyAR Mega Annotation

EasyAR Mega Annotation (EMA) — это формат данных для обмена пространственными аннотациями. Файлы обычно используют расширение .ema. Документ EMA может описывать связь между указанными Mega Block и аннотациями, а также данные расширений, определенные приложениями или третьими сторонами.

Сценарии использования

Формат EMA часто используется в следующих сценариях:

Для разработки Mini Program он предоставляет возможность создавать 3D-контент, точно совмещенный с реальным миром, решая проблему отсутствия в WeChat редактора для размещения и предварительного просмотра контента относительно block mesh.
Для навигационных сценариев, например AR-навигационных решений, он предоставляет единые данные графа навигационных точек для функций навигации между app и Mini Program.
Используйте Mega Toolbox, чтобы предварительно просматривать эффект через модель аннотаций.

Примечание

Если приложение запускается только в Unity, данные формата EMA обычно не требуются. Сцен и функций сериализации Unity достаточно для реализации соответствующих функций.

Создание и хранение

Mega Studio может создавать и редактировать данные EMA, поддерживая следующие функции:

Визуально редактировать данные аннотаций в 3D-сцене.
Импортировать/экспортировать документы EMA.
Подключаться к базе данных localization Mega и загружать/скачивать документы EMA.

Документы EMA можно хранить локально как отдельные файлы или в базе данных localization Mega. Размер каждого документа EMA в базе данных localization ограничен 4 MB.

Чтение и использование

Документы EMA можно читать и использовать на разных платформах.

Unity
Mini Program

API данных
Используйте EmaDecoder.Decode для декодирования документов EMA
Unity пока не предоставляет интерфейс для загрузки документов EMA из сервиса

См. пример MegaBlock_Ema для использования.

Версия формата

Документы EMA объявляют версию формата через поле version корневого объекта.