Table of Contents

Миграция приложений Unity с EasyAR Sense Unity Plugin 4.2 и более старых версий

Начиная с версии 4.3, Unity plugin распространяется и управляется через Unity Package Manager, при этом структура пакета плагина значительно изменилась. Поэтому при переходе с версии 4.2 или ниже на версию 4.3 или выше требуются дополнительные шаги.

Шаги миграции

При переходе с версии 4.2 или ниже необходимо:

  1. Удалить все файлы старой версии плагина. Эти файлы могут находиться в папках Assets/EasyAR, Assets/Plugins, Assets/Samples и Assets/StreamingAssets.
  2. Затем импортировать новую версию через Package Manager window Unity.
  3. Обновить сцены и код, следуя руководствам по миграции для соответствующих версий ниже.

Миграция на версию 4000 и новее

Переход на версию 4000 и новее требует внесения следующих изменений.

Обратитесь к разделу Создание и настройка AR-сессии для воссоздания структуры сцены.

Связанные изменения:

  • prefab удалены.
  • VIOCameraDeviceUnion удален.

Для использования AR Foundation обратитесь к разделу Включение AR Foundation в проекте EasyAR.

Связанные изменения:

  • Поддержка AR Foundation была переработана.

Вы не можете использовать EasyAR на устройствах XREAL X и XREAL Light. Рекомендуется перейти на XREAL Air2 Ultra.

Связанные изменения:

  • Nreal/XREAL X и Nreal/XREAL Light больше не поддерживаются.
  • Поддержка XREAL встроена в EasyAR Sense и включает XREAL Air2 Ultra.

Обратитесь к разделу Миграция на версию 4000 для продолжения процесса миграции.

Версия 4000 содержит больше изменений по сравнению с 4.x.

Миграция на версию 4.6

Предупреждение

Версия 4.6 больше не поддерживается. Рекомендуется напрямую обновиться до версии 4000 или новее. Подробная документация по разработке для Unity на сайте EasyAR предназначена для версий 4000 и выше.

Переход на версию 4.6 требует внесения следующих изменений.

Рекомендуется обратиться к примерам версии 4.6, чтобы понять новую структуру сцены, и воссоздать соответствующие компоненты.

Связанные изменения:

  • prefab удалены.
  • VIOCameraDeviceUnion удален.
  • Поддержка AR Foundation была выделена в отдельный пакет.

Если вам не нужна поддержка AR Foundation, вы можете удалить узел AR Foundation в AR Session на сцене и использование ARFoundationFrameSource в коде.

Связанные изменения:

  • Поддержка AR Foundation была выделена в отдельный пакет.

Если вам не нужна поддержка Nreal, вы можете удалить узел Nreal в AR Session на сцене и использование NrealFrameSource в коде. При использовании Nreal больше не требуется создавать виртуальный пакет.

Связанные изменения:

  • Поддержка Nreal была выделена в отдельный пакет.

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

Связанные изменения:

  • Некоторые другие интерфейсы скриптов также изменились.
  • Некоторые публичные методы в XML-комментариях помечены как internal. Следует избегать использования этих интерфейсов; они были удалены в версии 4000.

Миграция на версию 4.4

Предупреждение

Версия 4.4 больше не поддерживается. Рекомендуется напрямую обновиться до версии 4000 или новее. Подробная документация по разработке для Unity на сайте EasyAR предназначена для версий 4000 и выше.

Переход на версию 4.4 требует внимания к следующим изменениям.

Необходимо по возможности удалить ссылки на prefab внутри пакета плагина. Если продолжать использовать эти prefab, будут появляться предупреждения в логах, содержащие краткие инструкции по их замене в новом плагине. Рекомендуется обратиться к примерам версии 4.4, чтобы понять новую структуру сцены.

Связанные изменения:

  • prefab помечены как устаревшие (obsolete) и удалены в версии 4.6.

Удалите использование VIOCameraDeviceUnion. Если продолжать использовать этот компонент, будут появляться предупреждения в логах, содержащие краткие инструкции по его замене в новом плагине. Рекомендуется обратиться к примерам версии 4.4, чтобы понять новую структуру сцены.

Связанные изменения:

  • VIOCameraDeviceUnion помечен как устаревший (obsolete) и удален в версии 4.6.

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

Связанные изменения:

  • Некоторые другие интерфейсы скриптов также изменились.
  • Некоторые публичные методы в XML-комментариях помечены как internal. Следует избегать использования этих интерфейсов; они были удалены в версии 4000.