Использование примеров для быстрого старта разработки на EasyAR Mega в Unity

Это руководство описывает, как настроить и запустить примеры EasyAR Mega для Unity, чтобы быстро начать разработку с EasyAR Mega.

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

Перед прочтением этого раздела убедитесь, что вы выполнили:

• Имеете действующее облачное хранилище локализации.
• Установили Unity (2021.3.30 LTS или новее), рекомендуется использовать последние версии Unity 2022.3 или Unity 6.3.
• Импортировали пакеты com.easyar.sense-**.tgz и com.easyar.mega-**.tgz согласно методу включения Mega.

Пример использования (шесть шагов)

Ниже описаны шесть шагов по настройке и запуску ключевого примера EasyAR Mega MegaBlock_Basic.

Первый шаг: импорт примера

Примечание

Если все примеры были импортированы через **All Samples**, этот шаг можно пропустить.

1. Используйте меню Window > Package Manager, чтобы открыть Package Manager. Выберите EasyAR Sense Unity Plugin. В правой части, в разделе Samples, разверните все доступные примеры.
2. Выберите нужный пример (например, MegaBlock_Basic) и нажмите Import.

Примечание

• Данное руководство не подходит для непосредственного использования с гарнитурами (headsets), но перед разработкой под гарнитуры необходимо изучить процесс с помощью разработки под смартфон.
• Если вы ранее импортировали примеры из старой версии SDK, после обновления SDK необходимо сначала удалить старые примеры, а затем импортировать их заново.

Шаг второй: Заполните лицензионный ключ и настройте сервис локации Mega Cloud

1. В строке меню выберите EasyAR > Sense > Configuration;
   
2. В открывшейся панели Project Settings вставьте ваш лицензионный ключ;
   

Совет

Лицензию EasyAR Sense можно создать в Центре разработки EasyAR. При первом использовании выполните следующие шаги:

• Создайте EasyAR Sense 4.x Personal
• Для карты разреженного пространства выберите Нет
• Название приложения укажите произвольно, в полях Bundle ID и Package Name введите com.mycompany.myproject
• Выберите созданную лицензию, затем нажмите кнопку копирования справа

Примечание

Bundle ID и Package Name можно изменить позже, но количество изменений ограничено. Если у вас есть определенное имя пакета приложения, вы можете указать его.

Для личной версии нет ограничений на создание, другие типы лицензий можно создавать по мере необходимости.

3. Настройте информацию вашей библиотеки локации Mega Cloud в разделе Mega Block панели Project Settings;
   

Совет

Конфигурацию библиотеки локации Mega можно получить в Центре разработки EasyAR.

Убедитесь, что ваш API-Key имеет права доступа к Mega Block. При отсутствии прав измените или создайте новый ключ.

Шаг третий: размещение 3d-контента

1. В панели Hierarchy щелкните правой кнопкой мыши на пустом месте, чтобы добавить инструмент просмотра блоков (разработка в Unity);
   

2. Доступ к сервису локализации Mega;

   1. Выберите узел EasyAR.Mega.BlockViewer (Dev), в панели Inspector введите данные своей учетной записи EasyAR и войдите;
      
   2. Нажмите кнопку справа от Mega Cloud Service;
      
   3. Выберите Сервис локализации Mega, который хотите использовать, нажмите OK.
      

3. Загрузка блока

   После выбора сервиса список блоков из текущей библиотеки отобразится под узлом MegaBlocks и в панели инструментов. Нажмите Загрузить, чтобы загрузить выбранный блок:
   

   После загрузки блок отобразится в окне Scene. Вы можете взаимодействовать в окне Scene, настраивая угол обзора и положение. Одновременно проверьте, пригоден ли файл блока (например, корректна ли система координат блока, нет ли расслоения, слишком ли он размыт, есть ли дефекты, мешающие размещению AR-ресурсов и т.д.).
   

4. Размещение 3d-контента

   Теперь вы можете размещать 3D-объекты, ориентируясь на блок.
   

   Примечание

   • 3D-объекты должны размещаться под автоматически созданным инструментом узлом MegaBlocks > Block_*, чтобы обеспечить корректную позицию рендеринга виртуального контента во время выполнения.
   • Не изменяйте имя узла Block_* и его local transform, они управляются инструментом автоматически.

Шаг четвертый: Настройка MegaTracker

1. Настройка Block Root;

   Разверните AR Session, выберите Mega Block Tracker и установите Block Root на сгенерированный инструментом узел MegaBlocks.
   

Пятый шаг: настройка Player

• Android
• iOS

В Unity меню File > Build Settings > Player Settings выберите значок Android, чтобы открыть настройки для платформы Android.

• Измените Package Name на Package Name, указанный на странице License Key

  

  Совет

  Например, если при создании License Key вы указали Package Name как com.mycompany.myproject, то здесь необходимо ввести Package Name com.mycompany.myproject, иначе приложение не запустится.

• Измените Minimum API Level на API Level 21 или выше

  

• Измените Scripting Backend на IL2CPP и в Target Architecture отметьте ARM64

  

Шаг шестой: сборка и запуск

1. Добавьте текущую сцену в File > Build Settings или Build Profiles > Scene List;
2. Переключитесь на целевую платформу (например, Android/iOS), проверьте совпадение идентификатора пакета (Bundle ID) и лицензионного ключа;
   
3. Нажмите Build And Run.
   

Результат работы в реальных условиях:

О жёлтом тексте на экране

Во время работы вы можете заметить два жёлтых текста на экране.

1. Предупреждение при работе в симуляционном режиме

   Оно расположено внизу экрана:

   

   Это предупреждение появляется потому, что приложение по умолчанию может работать не на месте. Оно незначительно влияет на производительность приложения. Если вы используете приложение непосредственно на месте, вы можете изменить конфигурацию MegaTracker перед сборкой.

2. Диагностическая информация

   Она расположена вверху экрана и используется для отслеживания состояния сессии и выявления проблем. Рекомендуется оставлять её включённой на этапе разработки и тестирования:

   

   Обратитесь к разделу Диагностическая информация в сцене для быстрого ознакомления с настройкой и использованием этой диагностической информации.

Следующий шаг: от новичка до профессионала

Поздравляем! Выполнив вышеуказанные шаги, вы успешно запустили ключевые примеры EasyAR Mega за 10 минут, лично испытав очарование пространственного позиционирования и наложения AR-контента.

Теперь вы освоили основы. Если вы хотите:

• Создавать более стабильные и эффективные AR-приложения
• Реализовать сложные эффекты, такие как виртуально-реальное перекрытие, выравнивание контента и другие
• Производить отладку без оборудования или при невозможности выехать на место

Обратитесь к следующим углубленным руководствам. Они помогут вам решить практические задачи, возникающие в процессе разработки.

Продвинутая разработка

Если вы хотите понять полную конфигурацию проекта, вы можете обратиться к следующим материалам:

• Использование Universal Render Pipeline (URP)
• Настройка Player
• Настройка EasyAR

Если вы хотите глубже изучить методы использования EasyAR, начните отсюда:

• Основы Unity-приложений на базе AR

Также рекомендуется прочитать следующее, чтобы помочь в разработке и отладке:

• Диагностика проблем и отчетность при разработке в Unity
• Имитация работы AR в Unity

Точное управление функционалом Mega

Ниже приведены материалы, которые помогут вам эффективнее использовать Mega в вашем приложении:

• Работа на месте и симуляция
• Лучшие практики работы с ARSession
• Добавление целей отслеживания
• Создание 3d-контента с выравниванием по реальному миру
• Окклюзия окружающей среды (Occlusion)
• Управление процессом отслеживания

Ниже приведены материалы, которые помогут вам проверить функционал Mega без необходимости выезда на место:

• Быстрая проверка с использованием ПК-камеры
• Симуляция с помощью инструмента Session Verification

Продвинутые темы

Следующие материалы более подходят для ознакомления после получения некоторого опыта работы с EasyAR.

Если вы хотите запустить EasyAR Mega на гарнитуре, обратитесь к следующим материалам:

• Поддержка гарнитур в EasyAR для Unity
• Использование примеров EasyAR на гарнитурах XR или очках дополненной реальности

Если вы хотите использовать AR Foundation, начните отсюда:

• Поддержка фреймворка Unity XR в EasyAR