Table of Contents

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

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

Подготовка пустого проекта unity

Убедитесь, что установлена совместимая версия Unity (Unity 2021.3 или новее). Рекомендуется использовать последние версии Unity 2022.3 или Unity 6.3.

Создайте пустой проект Unity, используя шаблон 3D (Built-in Render Pipeline):

Примечание

При первом использовании не рекомендуется использовать URP.

Если вы используете Unity 6, вам потребуется вручную скачать и использовать 3D (Built-In Render Pipeline) Template. При стандартной установке он находится в нижней части списка шаблонов.

Важно

Для использования URP необходимо выполнить дополнительные настройки в соответствии с инструкциями Universal Render Pipeline (URP), иначе изображение с камеры отображаться не будет.

Импорт easyar sense unity plugin

  • Скачивание пакета плагина
    • Скачайте последнюю версию EasyAR Sense Unity Plugin, которая включает примеры (samples).
    • После распаковки скачанного zip-архива вы увидите readme и файлы .tgz. Файлы .tgz можно импортировать напрямую в Unity, не распаковывая.
    • Поместите файл .tgz в папку Packages вашего проекта Unity.
  • Импорт пакета плагина
    • В меню выберите Window -> Package Manager.
    • В открывшемся окне нажмите значок + вверху слева и выберите Install Package from tarball ....
    • В диалоговом окне выберите упомянутый выше файл .tgz.

ImportUnityPlugin

Примечание

Файл .tgz нельзя удалять или перемещать после импорта в Unity. Перед импортом поместите этот файл в подходящее место. Обычно рекомендуется хранить его в папке Packages проекта Unity для удобства управления версиями.

Импорт примеров

Откройте Package Manager через меню Window > Package Manager, выберите EasyAR Sense Unity Plugin. В правой части выберите **All Samples**, чтобы единовременно импортировать все примеры.

ImportSample

Осторожно

**All Samples** и другие примеры нельзя импортировать одновременно, иначе возникнут дублирующиеся файлы, что приведет к потере части ресурсов сцены. Если вы случайно импортировали повторяющиеся файлы, удалите их и выполните импорт заново.

Изменение списка сцен

Откройте Build Settings (или Build Profiles),

Добавьте примеры сцен из проекта Unity в Scene List в Build Settings или Build Profiles, и переместите сцену-лаунчер примеров (AllSamplesLauncher) на первое место среди всех сцен.

Осторожно

Обратите внимание, не добавляйте эти сцены для гарнитур, иначе сборка может завершиться ошибкой:

  • Combination_BasedOn_AppleVisionPro.rst
  • Combination_BasedOn_Xreal.rst

Заполнение лицензионного ключа (License Key)

В меню Unity выберите EasyAR > Sense > Configuration, чтобы открыть интерфейс настроек EasyAR Sense.

FillInKey

В поле ввода под EasyAR Sense License вставьте ваш EasyAR Sense License.

FillInKey2

Совет

EasyAR Sense License можно создать в Центре разработки EasyAR (中文, English). При первом использовании создайте ключ, следуя этим шагам:

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

copykey

Примечание

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

Создание персональной версии (Personal Edition) не ограничено по количеству. Другие типы лицензий можно создавать по мере необходимости в процессе эксплуатации.

Запуск в редакторе

Для запуска в редакторе требуется, чтобы к вашему компьютеру была подключена камера.

Подтвердите работу системной камеры

Откройте Системное приложение камеры:

Убедитесь, что камера работает корректно:

Обязательно закройте приложение камеры после проверки, чтобы избежать конфликтов при запуске примеров.

Примечание

EasyAR использует только системные интерфейсы для доступа к камере. Убедитесь, что Системное приложение камеры может открыть камеру и отобразить изображение.

Запуск примера

В следующем примере используется демонстрация отслеживания изображений ImageTracking_Targets. Другие примеры запускаются аналогично.

Откройте сцену-лаунчер с примерами и нажмите кнопку Play в верхней части редактора Unity.

Перейдите в сцену ImageTracking_Targets.

Совет

Также можно напрямую открыть сцену ImageTracking_Targets и запустить её.

Наведите камеру на следующее целевое изображение:

namecard

Ссылка для скачивания: 🔗 namecard

EasyAR распознает и отследит это изображение, а затем наложит виртуальные объекты.

Примечание

Некоторые функции недоступны в редакторе при подключении камеры, но работают на телефоне. Примеры, недоступные в редакторе, покажут всплывающее окно при запуске.

Одновременно будет отображаться сообщение и вывод ошибки в логе.

На телефоне

Для запуска на телефоне требуется сборка. Перед сборкой необходимо изменить настройки Player.

Изменение настроек 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 21 или выше

    androidAPILevel

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

    androidarm64

Создание сборки приложения

Выберите File > Build Settings, выберите целевую платформу (Android/iOS), затем выберите switch platform.

switchplatform

Выберите Build или Build And Run, чтобы скомпилировать проект и установить его на телефон. При запуске необходимо разрешить соответствующие разрешения.

buildandrun

Пример запуска

Следующее содержание использует пример отслеживания изображений ImageTracking_Targets в качестве образца. Другие примеры запускаются аналогично.

После запуска должна стартовать сцена-лаунчер примеров.

Совет

Если после открытия вы не попали в сцену-лаунчер примеров, проверьте, правильно ли настроен список сцен в Build Settings или Build Profiles, и переместите AllSamplesLauncher на первое место.

Перейдите в сцену ImageTracking_Targets.

Наведите камеру телефона на следующее целевое изображение:

namecard

Ссылка для скачивания: 🔗 namecard

EasyAR распознает и отследит это изображение, добавив поверх него виртуальные объекты.

Следующие шаги

Вы успешно запустили пример Unity AR и, возможно, интересуетесь тем, как создаются AR-сцены, демонстрируемые в примере. Вы можете прочитать следующие руководства по порядку:

Подробную инструкцию по использованию запуска примеров можно найти здесь:

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

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