Настройка проекта Unity

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

В этом руководстве описаны рекомендуемые версии редактора, настройки графики, URP и настройки проекта для Android при разработке приложения Unity для Android XR.

Требования

Чтобы разрабатывать игры с помощью Unity, вам нужно скачать и установить Unity Hub.

Установите версию 6000.0.58f2 или более позднюю версию Unity Editor и Android Build Support, в которую входят:

  • OpenJDK
  • SDK для Android
  • Инструменты Android NDK

Как выбрать движок рендеринга

Для отрисовки приложений Android XR рекомендуем использовать Vulkan Graphics API. Чтобы выбрать Vulkan в качестве графического API, выполните следующие действия:

  1. В Unity выберите Edit (Изменить) > Project Settings (Настройки проекта) > Player (Игрок).
  2. Перейдите на вкладку Android и выберите Другие настройки > Рендеринг.
  3. Если включен Auto Graphics API, отключите этот параметр, чтобы открыть раздел Graphics APIs (API графики).
  4. В разделе Graphics APIs (Графические API) нажмите кнопку Add (+) (Добавить (+)) и выберите Vulkan в раскрывающемся списке.

    Пример того, как изменить настройки Graphics API в интерфейсе

  5. Измените порядок графических API, используя маркеры (=), чтобы Vulkan был указан первым.

  6. При необходимости выберите другие API графики и нажмите кнопку Удалить (-).

Универсальный конвейер отрисовки

Android XR совместима с универсальным конвейером рендеринга (URP). Если вы планируете использовать сквозную передачу, обновите настройки URP по умолчанию, чтобы обеспечить оптимальную производительность сквозной передачи на Android XR.

В таблице ниже приведены рекомендуемые настройки URP в Unity, которые более подробно описаны в следующих разделах.

Параметр

Местоположение

Рекомендуемое значение

HDR

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

Отключено

Постобработка

Данные универсального средства отрисовки

Отключено

Настройки объекта Universal Render Pipeline

Чтобы оптимизировать объект Universal Render Pipeline для Android XR, выполните следующие действия:

  1. Найдите ресурс универсального конвейера отрисовки для своего проекта. Для этого введите t:UniversalRenderPipelineAsset в строку поиска в окне Проект.

  2. В разделе Качество отключите параметр HDR.

    Объект Universal Render Pipeline с рекомендуемыми настройками

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

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

  1. Найдите объект данных универсального средства визуализации проекта. Для этого введите t:UniversalRendererData в строку поиска окна Проект.

  2. В Инспекторе в разделе Постобработка снимите флажок Включено.

    Данные универсального обработчика, показанные с рекомендованными настройками

Минимальный уровень API Android

Установите для проекта минимальный уровень API 24, который требуется для загрузчика OpenXR. В противном случае сборки могут завершиться с ошибкой.

Чтобы задать минимальный уровень API Android, выполните следующие действия:

  1. Выберите Edit (Правка) > Project Settings (Настройки проекта) > Player (Проигрыватель).
  2. Откройте вкладку Android и выберите Другие настройки.
  3. В разделе Идентификация для параметра Минимальный уровень API выберите 24 или более позднюю версию.

Точка входа в приложение

Настройте следующие параметры точки входа приложения:

  1. Выберите Edit (Правка) > Project Settings (Настройки проекта) > Player (Проигрыватель).
  2. Перейдите на вкладку Android и откройте Другие настройки.
  3. В разделе Configuration (Конфигурация) убедитесь, что в поле Application Entry Point (Точка входа приложения) установлен флажок GameActivity и снят флажок Activity (Действие).

Диал. окна

Большинству приложений Android XR требуются окна с изменяемым размером, поскольку они должны отображать диалоговые окна, например запросы разрешений системы.

Чтобы диалоговые окна отображались правильно, выполните следующие действия:

  1. Выберите Edit (Правка) > Project Settings (Настройки проекта) > Player (Проигрыватель).
  2. Выберите вкладку Android и откройте раздел Разрешение и презентация.
  3. В разделе Разрешение включите параметр Изменяемый размер окна.

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


OpenXR™ и логотип OpenXR являются товарными знаками, принадлежащими компании Khronos Group Inc. и зарегистрированными в Китае, Европейском союзе, Японии и Великобритании.