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

Применимые устройства XR
Данное руководство поможет вам создавать приложения для устройств XR такого типа.
Узнайте о типах устройств XR →
XR-гарнитуры
Проводные XR-очки
Узнайте о типах устройств XR →

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

Предварительные требования

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

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

    1. Установите Unreal Engine версии 5.6.1 (или выше) через Epic Games Launcher.

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

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

  4. Установите Android Studio (Panda 4 | 2025.3.4 Patch 1 или выше).

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

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

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

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

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

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

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

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

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

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

Создайте проект Unreal XR

Далее создайте новый проект и настройте его с необходимыми XR-плагинами и входными данными:

  1. Запустите Unreal Engine 5.6.1.
  2. В разделе «Категории новых проектов» выберите шаблон «Виртуальная реальность» .
  3. В меню «Настройки проекта» установите для параметра «Целевая платформа» значение «Мобильные устройства» .
  4. Для обеспечения оптимальной производительности на мобильных устройствах XR установите параметр « Масштабируемое качество» .
  5. Выберите название проекта, а затем нажмите «Создать» .

Настройка параметров Android

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

  1. Перейдите в меню «Редактировать» > «Настройки проекта» .
  2. Перейдите в раздел Платформы > Android .
  3. Если кнопка «Принять лицензию SDK» выделена красным, нажмите на неё.
  4. В разделе APKPackaging :
    • Установите минимальную версию SDK на 34 .
    • Установите целевую версию SDK на 34 (или выше).

  5. Прокрутите страницу дальше до раздела «Сборка» и выберите «Поддержка Vulkan» .

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

Настройка параметров рендеринга

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

  1. Перейдите в меню «Редактировать» > «Настройки проекта» и выберите «Движок» > «Рендеринг» .

  2. В разделе «Forward Renderer» выберите «Forward Shading» .

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

  3. В разделе «Настройки по умолчанию» установите метод сглаживания на MSAA .

  4. В разделе «Мобильные устройства» установите значение Mobile MSAA на 4x .

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

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

    1. Clear Mobile HDR .

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

    2. Выберите «Мобильный просмотр на мобильном устройстве» .

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

См. также

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