Table of Contents

Импортируйте последнюю версию плагина EasyAR, чтобы включить функции Mega

В этой статье описано, как импортировать последнюю версию EasyAR Sense Unity Plugin (for Mega), чтобы включить функции Mega.

Для использования Mega импортируйте последнюю версию плагина EasyAR

Требуется Unity 2021.3.30 или более новая версия.

На странице загрузки вы увидите две версии Unity plugin: EasyAR Sense Unity Plugin и EasyAR Sense Unity Plugin (for Mega). Основные различия между ними такие:

  • EasyAR Sense Unity Plugin: не содержит файлов поддержки Mega, поэтому не может использоваться для разработки Mega. EasyAR предоставляет загрузку исторических версий начиная с 4.6.
  • EasyAR Sense Unity Plugin (for Mega): содержит файлы поддержки Mega и может использоваться для разработки Mega. EasyAR не предоставляет загрузку исторических версий.

В версиях 4000 и выше, если номер версии одинаковый, файлы EasyAR Sense Unity Plugin внутри обоих zip-пакетов (то есть com.easyar.sense) полностью одинаковы и могут заменять друг друга. Поэтому, если вы уже скачали и импортировали последнюю версию EasyAR Sense Unity Plugin, можно прямо извлечь com.easyar.mega из пакета EasyAR Sense Unity Plugin (for Mega) и импортировать его в Unity project, не переимпортируя весь пакет plugin.

Примечание

После версии 4000 при импорте несовместимых com.easyar.sense и com.easyar.mega compiler scripts выдаст error о несоответствии версий. Убедитесь, что com.easyar.sense и com.easyar.mega взяты из одной версии пакета plugin или совместимы друг с другом.

В версии 4.7 номера версий com.easyar.sense и com.easyar.mega должны полностью совпадать, включая все цифры и буквы после них, чтобы обеспечить совместимость.

Перед выпуском приложения рекомендуется снова проверить сайт EasyAR. Если есть новая версия EasyAR Sense Unity Plugin (for Mega), скачайте и импортируйте последнюю версию, чтобы приложение могло нормально использовать последние сервисы Mega, а также для максимальной совместимости и лучшей производительности.

Важно

Приложения, разработанные на устаревшей версии EasyAR Sense Unity Plugin (for Mega), могут не работать с последними сервисами Mega. Если онлайн-служба не изменилась (то есть версия localization library Mega не обновлялась), приложение, собранное с помощью старой версии EasyAR Sense Unity Plugin (for Mega), по-прежнему может работать нормально.

Импорт плагина EasyAR и пакета поддержки Mega

После распаковки загруженного zip-пакета вы увидите readme и несколько файлов tgz. Файлы tgz можно импортировать в Unity напрямую, не распаковывая их снова.

Способ импорта:

  • В строке меню нажмите Window и выберите Package Manager
  • В открывшемся окне нажмите кнопку + в левом верхнем углу и выберите Install Package from tarball ...
  • В появившемся диалоге выберите загруженный и распакованный файл .tgz
  • Только com.easyar.sense можно использовать для разработки приложений Mega, но не поддерживаются загрузка block mesh и editor-функции вроде размещения контента по опоре.
  • Если импортировать com.easyar.sense и com.easyar.mega, можно разрабатывать приложения Mega с поддержкой загрузки block mesh и editor-функций вроде размещения контента по опоре.
  • Обычно com.easyar.mega.studio импортировать не нужно. Этот tool нельзя использовать для разработки Unity, он нужен только для создания и импорта annotation data и просмотра эффекта с помощью Mega Toolbox.

Порядок импорта двух .tgz файлов com.easyar.sense и com.easyar.mega не важен; можно сначала импортировать com.easyar.sense, а можно сначала com.easyar.mega.

alt text

После успешного импорта com.easyar.sense и com.easyar.mega в окне Console Unity не должно быть никаких ошибок. Кроме того, если открыть окно Package Manager, можно увидеть, что EasyAR Sense Unity Plugin и EasyAR Mega Support уже импортированы и показывают номер только что импортированной версии.

alt text

Совет

com.easyar.mega зависит от ряда сторонних пакетов, таких как com.unity.cloud.ktx и com.unity.cloud.gltfast. При импорте убедитесь, что сетевое соединение работает нормально, чтобы Unity могла автоматически загрузить и импортировать эти зависимости.

В некоторых сетевых условиях процесс импорта зависимостей может идти медленно. Рекомендуется изменить сетевую среду или попробовать импорт несколько раз, пока все зависимости не будут успешно импортированы.

Примечание

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

Включение поддержки cloud localization Mega

Проверьте и включите опцию Mega > Mega Block/Landmark support в панели Project Settings:

После импорта com.easyar.mega эта опция включается по умолчанию, а если пакет не импортирован, она по умолчанию выключена.

Примечание

Включение поддержки cloud localization Mega принудительно добавляет разрешение на точную localization (fine). Для наилучшего результата это разрешение необходимо при использовании функций Mega.

Включение поддержки Mega Go localization на стороне устройства

Совет

Функция доступна только на Android

В настройках Android Player необходимо задать Minimum API level 24 или выше.

Установите для Android, iOS или visionOS в Lib Variants в Project Settings значение Full, чтобы включить поддержку Mega Go localization на стороне устройства в соответствующей системе:

После импорта com.easyar.mega функция включается по умолчанию, а если пакет не импортирован, она по умолчанию выключена.

Текущий статус можно посмотреть через Mega > Mega Go support:

Включение 5DoF camera device на основе инерции

Совет

Функция доступна только на Android

В настройках Android Player необходимо задать Minimum API level 24 или выше.

Если устройство не поддерживает 6DoF camera, включение 5DoF camera device на основе инерции может значительно увеличить число поддерживаемых Mega устройств и одновременно дать лучший пользовательский опыт.

Установите Lib Variants > Android в панели Project Settings в значение Full, чтобы включить эту функцию:

После импорта com.easyar.mega функция включается по умолчанию, а если пакет не импортирован, она по умолчанию выключена.

Текущий статус можно посмотреть через Mega > InertialCameraDevice support:

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