Включение поддержки AR Foundation в проекте EasyAR
Если требуется включить поддержку AR Foundation в EasyAR или использовать другие функции AR Foundation, необходимо правильно установить и настроить AR Foundation. Ниже описано, как выполнить эти действия.
Перед началом
- Прочтите Поддержка EasyAR для фреймворка Unity XR, чтобы узнать о поддержке EasyAR фреймворка Unity XR и в каких случаях можно рассмотреть использование AR Foundation.
Совместимость версий AR Foundation
EasyAR поддерживает AR Foundation 5 или более новые версии.
Важно
Поддержка AR Foundation реализована через пользовательскую камеру.
При использовании пробных продуктов (например, лицензии Personal, пробной лицензии XR или пробного сервиса Mega) на пользовательских камерах или гарнитурах, EasyAR Sense перестает отвечать через 100 секунд после каждого запуска (пользователи Mega могут запросить изменение этого времени через EasyAR Business после утверждения). Использование платной версии EasyAR Sense и платного сервиса EasyAR Mega не имеет этого ограничения.
Установка AR Foundation
Рекомендуется обратиться к официальной документации AR Foundation для установки AR Foundation. Перед чтением убедитесь, что выбрана соответствующая версия документации.
Unity 2022 и новее
Если в проекте не установлены плагины XR, в Project Settings > XR Plug-in Management нажмите кнопку Install XR Plugin Management, чтобы установить XR Plug-in Management, и дождитесь завершения установки.
Если требуется использовать AR Foundation на платформе Android, в разделе Android установите флажок Google ARCore и дождитесь завершения установки.
Если требуется использовать AR Foundation на платформе iOS, в разделе iOS установите флажок Apple ARKit и дождитесь завершения установки.
Если требуется использовать AR Foundation на платформе visionOS, прочтите Настройка проекта для Vision Pro.
Совет
Рекомендуется оставить Initialize XR On Startup включённым, чтобы гарантировать инициализацию AR Foundation в момент по умолчанию.
После завершения установки откройте окно Package Manager, где в списке установленных пакетов должны отображаться AR Foundation и соответствующие плагины для платформ. Обратите внимание, что их версии должны полностью совпадать.
Важно
При установке и обновлении AR Foundation убедитесь, что версии Google ARCore XR Plugin и Apple ARKit XR Plugin полностью соответствуют версии AR Foundation. Несоответствие версий может привести к ошибкам во время выполнения или некорректной работе функций.
Unity 2021
В Unity 2021 необходимо вручную редактировать файл Packages/manifest.json, чтобы указать версии, как описано в официальной документации.
Например, для установки AR Foundation версии 5.2.0 и использования на Android и iOS, убедитесь, что файл Packages/manifest.json содержит следующее:
{
"dependencies": {
...
"com.unity.xr.arcore": "5.2.0",
"com.unity.xr.arfoundation": "5.2.0",
"com.unity.xr.arkit": "5.2.0",
...
}
}
Настройка XR Plug-in
При использовании EasyAR наличие ARCore обычно не является обязательным. Поэтому ARCore следует настроить как опциональный, чтобы приложение могло работать на устройствах без поддержки ARCore.
В Project Settings > XR Plug-in Management > ARCore установите для Requirement и Depth значение Optional.
Осторожно
Если установить Requirement в Required и установить собранное приложение на устройство без поддержки ARCore, устройство ошибочно сообщит, что ARCore доступен, и будет работать с ARCore. Это создаст ложное впечатление, что устройство использует ARCore и работает некорректно (чёрный экран или другие аномалии), но это не так.
Это происходит потому, что Google Play Store запрещает установку приложений, помеченных как требующие ARCore, на неподдерживаемых устройствах, поэтому такие приложения всегда предполагают, что они работают на поддерживаемом устройстве.
При правильной настройке эти устройства во время сборки сессии определят, что ARCore не поддерживается, и будут использовать функциональность EasyAR.
При необходимости вы также можете обратиться к следующим официальным документам для дополнительной настройки ARCore и ARKit. Перед чтением убедитесь, что выбрана соответствующая версия документации.
Настройка Universal Render Pipeline
Если в текущем проекте используется URP, необходимо настроить URP-актив. При неправильной настройке фоновое изображение камеры AR Foundation может отображаться некорректно.
Сначала убедитесь, что правильно настроен Renderer Feature URP для EasyAR, как описано в Настройка Universal Render Pipeline для EasyAR.
Затем в списке Renderer Features добавьте ARBackgroundRendererFeature.
Как и в случае с настройкой Renderer Feature URP для EasyAR, обратите внимание на конфигурации для разных платформ в Project Settings > Quality. Убедитесь, что на всех платформах, где требуется использовать AR Foundation, используется URP-актив, в котором правильно настроен ARBackgroundRendererFeature.
Также вы можете обратиться к официальной документации AR Foundation по настройке URP для настройки. Перед чтением убедитесь, что выбрана соответствующая версия документации.
Примечание
Настройка Universal Render Pipeline для EasyAR по-прежнему необходима, чтобы гарантировать корректный рендеринг функций, связанных с интерфейсами EasyAR, на устройствах без поддержки AR Foundation.
Включение поддержки AR Foundation в EasyAR
В Project Settings > EasyAR > Sense убедитесь, что опция Unity XR > AR Foundation Support включена. Эта опция включена по умолчанию.
Изменение этой опции вызывает перекомпиляцию скриптов. Необходимо дождаться завершения компиляции, чтобы изменения вступили в силу. Если Unity по какой-то причине не запустил компиляцию автоматически, закройте Unity и удалите папку Library/ScriptAssemblies, чтобы принудительно перекомпилировать скрипты.
Совет
Если EasyAR несовместим с AR Foundation в проекте и нет необходимости одновременно использовать EasyAR и AR Foundation, эту опцию можно отключить.
Следующие шаги
- Узнайте о Настройке сцены AR Foundation и использовании в проекте EasyAR
- Узнайте, как автоматически переключаться на AR Foundation в зависимости от поддержки устройства