Table of Contents

Быстрый старт в разработке с использованием EasyAR Mega для Unity с помощью примеров

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

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

Перед прочтением этой статьи убедитесь, что вы выполнили следующие действия:

Примечание

Этот учебник применим только для версии Unity-плагина >= 4003. Если вы случайно загрузили старую версию, но все еще читаете документацию по началу работы, вам сначала нужно загрузить последнюю версию плагина.

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

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

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

Примечание

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

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

Import Sample

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

Второй шаг: Настройка SDK и сервиса облачной локализации Mega

  1. В меню выберите EasyAR > Sense > Configuration;
    License Guide

  2. В открывшейся панели Project Settings вставьте свой License Key;
    Fill License

    Совет

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

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

    copykey

    Примечание

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

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

  3. Проверьте и включите параметр Mega > Mega Block/Landmark support в панели Project Settings;

  4. Настройте все параметры своей облачной библиотеки локализации Mega в разделе Mega Block панели Project Settings;
    Mega Config Guide

    Совет

    Настройки облачной библиотеки локализации Mega можно получить на EasyAR Developer Center.
    Mega Config Detail
    Убедитесь, что у вашего API Key есть разрешения на Mega Block и SpatialMap. Если их нет, необходимо изменить или создать новый ключ.
    API Key Auth
    Если библиотека локализации не найдена, сначала правильно настройте библиотеку локализации, а затем снова проверьте действительность облачной библиотеки локализации.

Третий шаг: Настройка Mega Block

  1. Настройте Mega Block;

    Выберите Mega Block и заполните идентификатор и имя блока.

    Совет

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

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

Четвёртый шаг: Размещение 3D-содержимого

  1. Выберите Mega Block и создайте инструмент редактора;

  2. Проверьте информацию о сервисе и подключитесь к сервису;

    Совет

    Если нет других изменений, информация о сервисе должна совпадать с той, что указана в Project Settings.

    После успешного подключения к сервису вы должны увидеть время обновления и интерфейс управления данными редактора Block.

  3. Загрузите данные редактора Block;

    Нажмите на первый выборочный блок под данными Block. Это запустит процесс загрузки данных редактора Block. После загрузки вы сможете увидеть сетку текущего Block в окне Scene:

    Совет

    Сетка Block будет переключать LOD в зависимости от положения камеры. Необходимо оставаться подключенным к сети.

  4. Разместите 3D-содержимое

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

    Примечание
    • 3D-объекты должны быть размещены под узлом Block, чтобы гарантировать правильное позиционирование виртуального содержимого во время выполнения.
    • 3D-объекты не могут быть размещены под узлом EasyAR.Mega.EditorTool. Этот узел используется только для инструмента редактора и в некоторых случаях может быть автоматически удален или пересоздан.

Пятый шаг: Изменение конфигурации Player

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

switchtoandroid

  • Измените Package Name на Package Name, отображаемый на странице License Key

    androidPackageName

    Совет

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

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

    androidAPILevel

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

    androidarm64

Шаг 6: Сборка и запуск

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

Вот как выглядит работа в реальном времени:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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