Создание и загрузка аннотаций с помощью редактора Unity

Эта статья описывает, как создавать и загружать аннотации с помощью Mega Studio в редакторе Unity.

Перед началом

Умение использовать Mega Studio в Unity
Подготовка модели: используйте модель из примеров проекта (милый панда) или модель робота из официального демо xr-frame. Также можно подготовить модель в формате GLTF, соответствующую требованиям xr-frame, руководствуясь спецификацией GLTF для XRFrame и поддерживаемыми расширениями.
Импортируйте файлы модели в Unity.

Совет

Плагин Mega уже включает зависимость от com.unity.cloud.gltfast, поэтому вы можете напрямую перетаскивать файлы моделей в Assets Unity.

Зачем нужны аннотации

EasyAR Mega Annotation (EMA) позволяет синхронизировать пространственное положение между платформами (с разными определениями систем координат).

Unity

Локальная система координат аннотации в среде Unity: положительное направление оси X — назад, Y — вверх, Z — вправо.

xr-frame

Локальная система координат аннотации в среде xr-frame: положительное направление оси X — назад, Y — вверх, Z — влево.

Эти различия обусловлены использованием разных систем координат (левосторонняя/правосторонняя) в Unity и xr-frame.

Использование EMA для синхронизации пространственного положения имеет значительные преимущества:

Упрощение процесса разработки: автоматическая обработка преобразования координат между платформами, исключая ручные расчеты, сложную логику и ошибки.
Повышение эффективности отладки: возможность прямой загрузки в MegaToolbox для быстрого тестирования на устройстве и проверки данных.

Шаги выполнения

Создание инструмента аннотации

В панели Hierarchy Unity щелкните правой кнопкой мыши и выберите: EasyAR Mega > Tool > Annotation Tool (Edit Mode).

После создания в сцене появятся два узла: EasyAR.Mega.Annotation и MegaBlocks.

Выберите узел EasyAR.Mega.Annotation. На его панели Inspector появятся поля для ввода имени пользователя/email и пароля.
Вход в аккаунт

Введите данные аккаунта EasyAR и пароль, затем нажмите "Войти". При успешном входе на панели Inspector появится инструмент Studio.
Выбор библиотеки локализации Mega Cloud

Нажмите значок справа от Mega Cloud Service.

Выберите библиотеку, которую хотите использовать.

После успешной загрузки информации библиотеки локализации и Mega Blocks панель инструментов Studio будет выглядеть следующим образом.
Загрузка плотной модели блока

Нажмите "Загрузить" справа от названия блока, чтобы динамически загрузить его плотную модель.

После загрузки модель появится на вкладке Scene. Обратите внимание: когда в левом нижнем углу появляется значок, как на изображении, это означает, что модель в текущей области видимости еще не загружена полностью. Подождите немного, пока значок исчезнет — это сигнализирует о завершении загрузки.
Создание аннотации

Удерживая клавишу Ctrl (Windows) / Command (Mac) в сцене, щелкните левой кнопкой мыши в нужном месте.
Использование модели

Перетащите импортированную модель в узел сцены, сделав ее дочерним узлом аннотации.

На панели Inspector модели измените значения Position и Rotation на 0. Scale можно настроить по необходимости.

Примечание

EMA обрабатывает всю логику преобразования координат. Установка Position и Rotation модели в 0 необходима для полного совпадения геометрического центра модели с точкой аннотации. Все перемещения и повороты должны выполняться путем манипуляций с ее родительским узлом (узлом аннотации).
[Опционально] Точная настройка положения модели

Если требуется точно настроить положение и ориентацию модели, см. Как использовать редактор Unity для точного выравнивания 3D-контента с реальным миром.
Создание нового пакета данных аннотации

Нажмите значок справа от пакета данных аннотации на панели Inspector.

Введите название для данных аннотации в поле и нажмите галочку справа.

После успешного создания должно выглядеть, как показано ниже. Затем нажмите "ОК" внизу.

Нажмите значок загрузки для выгрузки.

После успешной выгрузки появится уведомление.
Запись ID аннотации

Вам необходимо записать название или ID данных аннотации, чтобы загрузить соответствующие данные аннотации в xr-frame.

После успешной выгрузки вы также увидите соответствующую информацию в своей библиотеке локализации Cloud.

Здесь также можно просмотреть название и ID выгруженных данных аннотации.