Настройка универсального конвейера рендеринга (URP)

В этом документе объясняется, как настроить проект Universal Render Pipeline (URP) для работы с функциями EasyAR.

Перед началом

• Ознакомьтесь с методами использования URP в Unity.
• Следуйте инструкциям в включении EasyAR в Unity для импорта плагина EasyAR Unity.

Создание актива универсального конвейера рендеринга

Примечание

Если проект Unity создан с использованием шаблона проекта URP или в проекте уже существуют UniversalRenderPipelineAsset и Universal Renderer, можно сразу перейти к подтверждению переключения проекта на URP.

В окне Project через контекстное меню Create > Rendering > URP Asset(with Universal Renderer) создайте необходимые активы:

Поиск актива универсального конвейера рендеринга для целевой платформы

1. Перейдите в меню Edit > Project Settings > Graphics.

   В слоте Default Render Pipeline должен быть назначен Universal Render Pipeline Asset.

   

   Совет

   В старых версиях Unity эта опция называлась Scriptable Render Pipeline Settings.

2. Перейдите в меню Project Settings > Quality.

   Выберите уровень качества для целевой платформы. Render Pipeline Asset ниже — это актив URP, используемый целевой платформой. Если он пуст, используется актив, настроенный в окне Graphics.

   

   Совет

   Если настройки в Quality отличаются от Graphics, система будет использовать актив из Quality.

Настройка актива универсального конвейера рендеринга

Важно

Активы URP, используемые в редакторе Unity и на устройствах Android/iOS, часто различаются. Настройки для редактора и устройств необходимо выполнять отдельно.

1. Выберите Universal Render Pipeline Asset, используемый целевой платформой, затем выберите используемые им Universal Renderer Data.

   

   Совет

   Если в проекте настроено несколько рендереров, убедитесь, что выбран тот, который используется камерой AR. Проверить текущий индекс можно в компоненте Camera сцены > Rendering > Renderer.

2. В Inspector панели Universal Renderer Data внизу нажмите Add Renderer Feature и добавьте EasyARCameraImageRendererFeature.

   

Особенности использования примеров EasyAR

Примеры сцен, входящие в плагин EasyAR Unity, по умолчанию используют материалы и шейдеры конвейера рендеринга Built-in. Unity автоматически преобразует эти материалы и шейдеры в версии, совместимые с URP, но некоторые ресурсы могут отображаться некорректно. В этом случае выполните ручное преобразование, следуя Convert assets using the Render Pipeline Converter.

Перейдите в меню Window > Rendering > Render Pipeline Converter, выберите Built-in to URP. Установите флажки Material Upgrade и Readonly Material Converter > нажмите Convert Assets внизу.

После преобразования материалы примеров будут отображаться нормально.

Часто задаваемые вопросы

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

В версиях 4000+ сессия перейдет в состояние Broken. В этом случае в логах или изображении будет указано BrokenReason как URP RenderPipeLineAsset not properly setup:

Для решения следуйте инструкциям в этом документе для правильной настройки Universal Render Pipeline Asset.

Связанные темы

• Совместимость с Unity