Table of Contents

EasyAR 配置

Страница конфигурации EasyAR доступна через меню Unity EasyAR > Sense > Configuration или Edit > Project Settings > EasyAR.

alt text

Здесь содержатся все глобальные настройки плагина EasyAR Sense для Unity.

alt text

Initialize On Startup

Инициализировать EasyAR при запуске. Как правило, рекомендуется оставить этот параметр включенным.

Если вы отключите этот параметр, вам нужно будет вручную инициализировать EasyAR Sense. Подробности можно найти в разделе Инициализация EasyAR Sense.

Лицензия EasyAR Sense

Настройки, связанные с лицензией EasyAR Sense.

LicenseKey

Ключ лицензии EasyAR Sense. Для использования функций EasyAR необходимо указать действительный лицензионный ключ.

Можно оставить пустым, только если инициализация EasyAR Sense выполняется вручную через интерфейсы.

Примечание

При использовании на устройствах гарнитур (Vision Pro, XREAL, Pico, Rokid и др.) требуется лицензия EasyAR XR.

Примечание

При использовании пробных продуктов (например, лицензии Personal, пробной лицензии XR или пробного сервиса Mega) на пользовательских камерах или гарнитурах, EasyAR Sense перестает отвечать через 100 секунд после каждого запуска (пользователи Mega могут запросить изменение этого времени через EasyAR Business после утверждения). Использование платной версии EasyAR Sense и платного сервиса EasyAR Mega не имеет этого ограничения.

Verify When Build

Проверять лицензионный ключ при сборке проекта Unity.

Если эта опция включена, процесс сборки проекта Unity проверит лицензионный ключ. Сборка завершится ошибкой, если лицензия недействительна на целевой платформе сборки или не включает имя пакета (Bundle ID), заданное в настройках Unity Player Settings. Если вам нужно использовать ключ лицензии, настроенный в другом месте, или требуется изменить имя пакета после процесса сборки Unity, эту опцию можно отключить.

Lib Variants

Конфигурация вариантов библиотеки EasyAR Sense.

EasyAR Sense обычно имеет несколько вариантов, и функции разных вариантов различаются. Здесь приведено сравнение вариантов библиотек, интегрированных в плагин.

Вариант Название варианта EasyAR Sense Различия в функциях Другие особенности
Normal Community/Enterprise Не включает запись экрана и инерциальную навигацию
Full CommunityFull/EnterpriseFull Включает инерциальную навигацию и некоторые другие функции Mega Больший размер файлов библиотеки
VideoRecording CommunityR Включает функцию записи экрана (только Android)
Совет

Некоторые варианты, которые нельзя использовать в Unity, не включены, например, вариант CommunityR для iOS.

Значения по умолчанию:

  • Пакет поддержки EasyAR Mega не импортирован: Normal
  • Пакет поддержки EasyAR Mega импортирован: Full

Рекомендуемые конфигурации:

  • Full : Использование EasyAR Mega или функции инерциальной навигации
  • Normal : Стремление к минимальному размеру пакета и неиспользование EasyAR Mega или поддержки инерциальной навигации
  • VideoRecording : Необходимость использования функции записи экрана (только Android)

Permissions

Конфигурация разрешений приложения. Как правило, рекомендуется оставить настройки по умолчанию.

За исключением разрешения на использование камеры, другие настройки разрешений нельзя изменить, они определяются настройками других функций.

Разрешение Можно изменить Условие включения Описание разрешения
Camera Да Разрешение на использование камеры, требуется для работы с камерой
AndroidMicrophone Нет Variant равен VideoRecording Разрешение на использование микрофона, требуется для записи видео
Location Нет Импортирован пакет поддержки Mega Разрешение на точное определение местоположения, требуется для работы с EasyAR Mega

Unity XR

Конфигурация, связанная с фреймворком Unity XR (например, AR Foundation).

AR Foundation Support

Переключатель поддержки AR Foundation, рекомендуется оставить включенным.

В редких случаях, например, если вам нужно использовать AR Foundation 4 или если обновление AR Foundation вызывает ошибки компиляции, вы можете отключить этот параметр, но при этом все функции, связанные с AR Foundation, в плагине также будут отключены.

Примечание

После изменения этого параметра скрипты будут автоматически перекомпилированы.

Unity XR Auto Switch

Конфигурация функции автоматического переключения объектов Unity XR (например, AR Foundation).

  • Editor ：Параметры режима редактирования
    • Disable AR Session ：При наличии ARSession отключить ARSession AR Foundation при редактировании.
  • Player ：Параметры режима запуска
    • Enable ：Включить управление во время выполнения. Обратите внимание: если вы отключите этот параметр, компоненты, отключенные в режиме редактирования, не будут восстановлены во время выполнения.
    • Enable If Desktop ：Включить на Windows/Mac.
    • Enable If Mobile AR On Startup ：При запуске переключателя включить, если загрузчик мобильного AR (ARKit/ARCore) активен. Как правило, для этого параметра необходимо, чтобы в XR Plug-in Management был выбран параметр Initialize XR on Startup.
    • Disable If Non Mobile AR Post Startup ：При запуске переключателя отключить, если есть другие загрузчики, кроме мобильного AR (ARKit/ARCore), но ни один из них не активен. Как правило, этот параметр используется, когда в XR Plug-in Management не выбран параметр Initialize XR on Startup.
    • Restore AR Session When Disabled ：При отключении функции восстановить (включить) все отключенные ARSession AR Foundation (независимо от того, были ли они отключены EasyAR). Этот параметр обычно используется для восстановления компонентов, отключенных при редактировании.

Подробное описание функции можно найти в разделе Автоматическое переключение Unity XR.

Mega

Конфигурация функции EasyAR Mega.

Mega Block/Landmark Support

Включить поддержку Mega Block/Landmark.

Этот параметр по умолчанию включен после импорта com.easyar.mega и отключен, если пакет не импортирован.

InertialCameraDevice Support

Только для чтения. Показывает, доступна ли функция инерциальной навигации в текущей конфигурации.

Если отображаемая информация не соответствует вашим потребностям, измените параметр Lib Variants в соответствии с ситуацией.

ONNX Support

Только для чтения. Показывает информацию о времени выполнения ONNX в текущей конфигурации.

Если отображаемая информация не соответствует вашим потребностям, измените параметры Lib Variants и ONNX Runtime (Bundled) в соответствии с ситуацией.

Mega Block > Localization Service Access [Global]

Конфигурация глобального сервера локализации Mega Block.

Mega Landmark > Localization Service Access [Global]

Конфигурация глобального сервера локализации Mega Landmark.

Spatial Map

Конфигурация функции пространственной карты EasyAR.

Service Access [Global]

Конфигурация глобального сервера разреженных карт.

Image Tracking

Конфигурация функции отслеживания изображений EasyAR.

Target Gizmo

Конфигурация Gizmos для ImageTarget в редакторе.

Включение этих параметров приведет к отображению соответствующих Gizmos в Unity Editor. Если в сцене слишком много целей данного типа, это может повлиять на производительность при запуске в редакторе. Производительность при запуске на устройстве не будет затронута.

Cloud Recognition (CRS) > Service Access [Global]

Конфигурация глобального сервера облачной распознавания.

Object Tracking

Конфигурация функции отслеживания объектов EasyAR.

Target Gizmo

Конфигурация Gizmos для ObjectTarget в редакторе.

  • Enable：Включить Gizmos.

Third-Party Libraries

Настройка сторонних библиотек.

ARCore SDK

Настройка ARCore SDK.

ARCore предоставляет возможность отслеживания движения на некоторых устройствах под управлением Android. Вы можете прочитать Отслеживание движения и функции EasyAR, чтобы узнать о связи между функциями EasyAR и отслеживанием движения, а также о необходимости и условиях использования ARCore.

  • AR Foundation Or Optional: ARCore SDK, распространяемый вместе с EasyAR или AR Foundation, будет включен в приложение в соответствии с настройками ARCore XR Plugin. В целом этот вариант рекомендуется, так как он автоматически обрабатывает ситуацию с AR Foundation.
  • Optional: Функции ARCore будут доступны на устройствах, поддерживающих ARCore и имеющих установленное Google Play Services for AR.
  • Required: Приложение будет запускаться только на устройствах, поддерживающих ARCore и имеющих установленное Google Play Services for AR.
  • External: Если вы используете AR Foundation или другой вариант распространения ARCore SDK, можно использовать этот вариант. В таком случае ARCore SDK, распространяемый вместе с EasyAR, не будет использоваться. Этот вариант также можно использовать, чтобы полностью исключить использование ARCore SDK в приложении.
Осторожно

Если вы установите ARCore SDK в значение Required, или в настройках ARCore в AR Foundation установите Requirement в значение Required, и затем установите упакованное приложение на устройство, не поддерживающее ARCore, устройство ошибочно сообщит, что ARCore доступен и будет работать с использованием ARCore. Это создаст иллюзию, будто эти устройства работают с ARCore и работают некорректно (черный экран или другие неисправности), но на самом деле это ошибка.

Эта проблема возникает потому, что Google Play Store предотвращает установку приложений, помеченных как требующих ARCore, на неподдерживаемых устройствах, поэтому эти приложения всегда предполагают, что они работают на поддерживаемых устройствах.

При правильной настройке эти устройства при сборке сеанса определят, что ARCore не поддерживается, и будут использовать функции EasyAR.

Подробное описание вариантов Optional и Required и другие настройки, необходимые для публикации приложения в Google Play Store, можно найти в документации Google (Китайская версия, Международная версия).

Примечание

В плагине EasyAR Sense Unity Plugin библиотеки и настройки для поддержки ARCore уже включены в пакет плагина, но для запуска на телефоне необходимо установить Google Play Services for AR.

Существует три разных источника ARCore SDK, которые можно использовать:

  • Использование ARCore SDK, распространяемого вместе с плагином

    В плагине интегрирована определенная версия ARCore SDK. Подробную информацию можно найти в разделе Совместимость версий ARCore, AR Engine. При использовании обертки EasyAR для ARCore не требуется дополнительно импортировать AR Foundation.

  • Использование ARCore SDK из AR Foundation

    Если вам нужно использовать ARCore SDK из AR Foundation, можно настроить его в соответствии с документацией Google (Китайская версия, Международная версия). В этом случае для опции ARCore SDK необходимо выбрать AR Foundation Or Optional или External.

  • Использование другого ARCore SDK

    Если в других сторонних плагинах или в проекте имеется вариант распространения ARCore SDK, можно использовать его. В этом случае для опции ARCore SDK необходимо выбрать External и настроить в соответствии с требованиями конкретного плагина или проекта.

Warn 32-bit-only ARCore-enabled build

Согласно документации Google, при запуске программы с только armv7-библиотеками на устройстве arm64 ARCore не будет работать корректно. При упаковке приложения, если не выбрана поддержка ARM64, появится предупреждение:

alt text

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

alt text

Осторожно

Если это действительно необходимо, можно выбрать Continue and don't warn me again или отключить этот параметр, что отключит проверку при упаковке. Отключение проверки не позволит избавиться от предупреждения при упаковке, но в некоторых случаях может привести к неисправностям при работе на устройствах, в том числе к сбоям или черному экрану.

AR Engine SDK

Настройка AR Engine SDK.

AR Engine предоставляет возможность отслеживания движения на некоторых устройствах под управлением Android. Вы можете прочитать Отслеживание движения и функции EasyAR, чтобы узнать о связи между функциями EasyAR и отслеживанием движения, а также о необходимости и условиях использования AR Engine.

  • AREngineInterop: AREngineInterop доступен. AR Engine SDK, распространяемый вместе с EasyAR, будет включен в приложение.
  • External: AREngineInterop доступен. AR Engine SDK, распространяемый вместе с EasyAR, не будет использоваться.
  • Disabled: AREngineInterop недоступен. AR Engine SDK, распространяемый вместе с EasyAR, не будет использоваться. Все функции, связанные с AR Engine, будут отключены.

ONNX Runtime (Bundled)

Включить ли встроенный ONNX Runtime. Опция имеет смысл только при Lib Variant равном Full.

Если вам нужно использовать другую версию ONNX, вы можете скачать новую версию с официального сайта ONNX и отключить эту опцию. Использование собственного несоответствующего бинарного файла ONNX может привести к непредвиденным ошибкам.

Workaround For Unity

Решения для проблем или нежелательных поведений в Unity.

GenerateXMLDoc

Генерирует XML-документацию при перезагрузке скрипта для работы IntelliSense в API-документации.

URP17RG_DX11_RuinedScene

Обходной путь для URP 17 Render Graph DX11, где сцена рендерится повреждённой. Опция отключена в Unity 6.2 и новее.

URP17RG_IOS_Glitches_Partial

Частичное решение для Unity Issue UUM-87787.

Описание проблемы: При получении текстуры камеры из EasyAR (как в примере ImageTracking_Coloring3D и примере Рабочий процесс ARSession (CameraDevice)) на устройствах iOS/Mac наблюдаются визуальные помехи и артефакты. Мы воспроизвели проблему в чистом пакете Unity и сообщили о ней: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Отслеживайте обновления по Unity Issue UUM-87787 и логам выпусков будущих версий Unity.