Table of Contents

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

Начиная с версии 4.3, Unity-плагин распространяется и управляется через 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 session, чтобы заново создать структуру сцены.

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

  • 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 вынесена в отдельный package.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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