Настройка проекта Unreal Engine

Поддерживаемые XR-устройства
Это руководство поможет вам создавать продукты для таких XR-устройств.
Подробнее о типах устройств XR…
XR-шлемы
Проводные XR-очки
Подробнее о типах устройств XR…

В этом руководстве подробно описаны рекомендуемые версии движка, необходимые SDK и настройки проекта Android при разработке приложения Unreal Engine для Android XR.

Требования

Прежде чем настраивать Unreal Engine для разработки под Android XR, установите следующие приложения и инструменты:

  1. Скачайте и установите Epic Games Launcher.

    1. В Epic Games Launcher установите Unreal Engine версии 5.6.x или 5.8.x.

  2. Настройте систему для сборки кода C++ (например, с помощью Visual Studio 2022 для Windows или Xcode для macOS). Дополнительную информацию можно найти в руководстве по настройке среды разработки C++ от Epic.

  3. Установите .NET 8.0 SDK.

  4. Установите Android Studio (Rabbit 2 | 2026.2.2 или более поздней версии).

Установите поддержку сборки Android

Поскольку Android XR зависит от определенных версий SDK, вам необходимо установить правильные инструменты сборки Android вместе с Unreal Engine.

  1. Откройте Epic Games Launcher.

  2. Нажмите на значок раскрывающегося списка рядом с установленной версией движка (кнопка Launch (Запустить)) и выберите Options (Параметры).

    1. Прокрутите страницу вниз до вариантов установки, выберите Android и нажмите Применить.
    2. Если появится запрос, разрешите антивирусу зарегистрировать все необходимые расширения имени файла.

  3. Установите Java JDK 17.

  4. В Android Studio используйте SDK Manager, чтобы установить следующие версии, необходимые для примеров Android XR:

    • SDK Platforms: 34, 35 и 36.
    • NDK: 29.0.x
    • Инструменты командной строки (все элементы)

  5. Следуйте инструкциям в руководстве по расширенной настройке и устранению неполадок от Epic, чтобы настроить следующие переменные среды:

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Как создать проект Unreal XR

Затем создайте проект и настройте его, добавив необходимые плагины и входные данные XR.

  1. Запустите Unreal Engine (версии 5.6.x или 5.8.x).
  2. В разделе New Project Categories (Категории новых проектов) выберите шаблон Virtual Reality (Виртуальная реальность).
  3. В меню Project Defaults (Настройки проекта по умолчанию) в разделе Target Platform (Целевая платформа) выберите Mobile (Мобильные устройства).
  4. Для параметра Quality Preset (Набор настроек качества) выберите значение Scalable (Масштабируемый), чтобы обеспечить оптимальную производительность на мобильных устройствах XR.
  5. Укажите название проекта и нажмите Создать.

Выберите настройки Android

Открыв проект, выполните следующие действия, чтобы задать необходимые уровни Android API и настройки графики для Android XR:

  1. Выберите Edit (Редактировать) > Project Settings (Настройки проекта).
  2. Перейдите в раздел Platforms (Платформы) > Android.
  3. Если кнопка Accept SDK License (Принять лицензию SDK) выделена красным, нажмите ее.
  4. В разделе APKPackaging:
    • В поле Minimum SDK Version (Минимальная версия SDK) укажите 34.
    • Установите для параметра Target SDK Version (Целевая версия SDK) значение 34 или выше.

  5. Прокрутите страницу вниз до раздела Build (Сборка) и выберите Support Vulkan (Поддержка Vulkan).

    Vulkan – это рекомендуемый высокопроизводительный графический API для Android XR.

Как настроить параметры отрисовки

Чтобы достичь высокой частоты кадров и четкости изображения, необходимых для Android XR, нужно также настроить Unreal Engine на использование оптимизированного пути рендеринга для мобильных устройств:

  1. Выберите Edit (Редактировать) > Project Settings (Настройки проекта) и перейдите в раздел Engine (Движок) > Rendering (Рендеринг).

  2. В разделе Forward Renderer (Прямой рендеринг) выберите Forward Shading (Прямое затенение).

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

  3. В разделе Default Settings (Настройки по умолчанию) для параметра Anti-Aliasing Method (Метод сглаживания) выберите значение MSAA.

  4. В разделе Mobile (Мобильные устройства) установите для параметра Mobile MSAA (Мобильное MSAA) значение 4x.

    MSAA обеспечивает наиболее четкие результаты для VR без эффектов размытия, вызванных временным сглаживанием (TAA).

  5. В разделе VR:

    1. Снимите флажок Мобильные устройства с поддержкой HDR.

      Отключение HDR на мобильных устройствах значительно снижает нагрузку на постобработку.

    2. Выберите Многоканальный режим на мобильных устройствах.

      Это позволяет движку отрисовывать оба глаза за один проход, что значительно повышает производительность процессора.

Дополнительная информация

Подробные инструкции по развертыванию шаблона проекта на устройстве Android приведены в статье Настройка проектов Unreal Engine для разработки под Android.