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

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

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

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

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

  1. Скачайте Godot 4.6.2 с официального сайта Godot .
  2. Убедитесь, что у вас есть XR-гарнитура или XR-очки .
  3. Установите Android Studio .

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

Для компиляции и экспорта пакетов, необходимых для пространственных вычислений, Godot требует наличия специальных инструментов сборки Android.

  1. В Android Studio используйте менеджер SDK для установки следующих пакетов и инструментов:

    • Платформа Android SDK : Android 14.0 ("UpsideDownCake") (уровень API 34)
    • Android SDK Build-Tools : версия 34.0.0 или выше
    • NDK : Любая версия 28.x
    • CMake : Версия 3.10.2

    Возможно, вам потребуется выбрать пункт «Показать сведения о пакете» в менеджере SDK, чтобы увидеть все доступные версии инструмента.

  2. В Godot перейдите в меню Редактор > Настройки редактора > Экспорт > Android и укажите путь к вашему SDK.

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

Создайте новый проект для пространственного рендеринга:

  1. Откройте Godot и создайте новый проект.

  2. Для параметра «Рендерер» выберите «Мобильный» .

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

    Диалоговое окно «Создать новый проект» в Godot Engine.

  3. Выберите любые другие необходимые параметры и нажмите «Создать» .

  4. Создайте свою внутреннюю XR-сцену (включая XROrigin3D и XRCamera3D ), используя официальное руководство по настройке XR-сцены Godot .

    Создайте свою внутреннюю XR-сцену в новом проекте Godot.

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

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

  1. Откройте Godot.
  2. Настройте следующие параметры проекта для OpenXR:
    • Перейдите в меню Проект > Настройки проекта > XR > OpenXR и выберите «Включено» .
    • Перейдите в меню Проект > Настройки проекта > XR > Шейдеры и выберите Включено .

  3. Перейдите в меню Рендеринг > Сглаживание > Качество > MSAA 3D ​​и выберите 4x .

    Эта настройка обеспечивает наилучшую четкость изображения в Android XR.

Настройте свой проект для экспорта в Android XR.

Выполните следующие шаги, чтобы настроить экспорт проекта в Android XR:

  1. Настройка параметров экспорта : перейдите в раздел Проект > Экспорт и нажмите Добавить... > Android .

  2. Выполните инструкции по развертыванию : следуйте официальному руководству по развертыванию Godot для Android , чтобы получить пошаговые инструкции по настройке разрешений и развертыванию в один клик.

  3. Проверьте версии SDK вашего проекта :

    • Для минимального SDK : 34
    • Для целевого SDK : 34

  4. Настройка режима XR : В настройках экспорта установите режим XR на OpenXR .

Установите плагин Godot OpenXR Vendors.

Для доступа к расширениям, специфичным для Android XR, ваше приложение должно использовать плагин Vendors. Выполните следующие шаги, чтобы получить совместимую версию:

  1. В Godot выберите AssetLib .

  2. Найдите "Поставщика".

    Различные версии плагина Godot OpenXR Vendors можно найти, выполнив поиск в библиотеке ресурсов Godot.

  3. Найдите версию 5.1 (или выше) плагина Godot OpenXR Vendors и скачайте её.

  4. После завершения загрузки выберите «Установить» .

    Установите плагин Godot OpenXR Vendors.

См. также

Для получения дополнительной информации о разработке Android XR с использованием Godot см. следующие страницы в документации Godot Engine: