Начало работы с MRTK2 и пакетом SDK для XR

Пакет SDK для XR — это новый конвейер XR Unity в Unity 2019.3 и более поздних версиях. В Unity 2019 это альтернатива существующему конвейеру XR. В Unity 2020 это единственный конвейер XR в Unity.

Настройка Unity для конвейера пакета SDK для XR

В настоящее время конвейер пакета SDK XR поддерживает 3 платформы: Windows Mixed Reality, Oculus и OpenXR. В разделах ниже описаны шаги, необходимые для настройки пакета SDK XR для каждой платформы.

Windows Mixed Reality

Перейдите в диспетчер пакетов Unity и установите пакет подключаемого модуля Windows XR, который добавляет поддержку Windows Mixed Reality в пакете SDK для XR. Это также приведет к извлечению нескольких пакетов зависимостей.

  1. Убедитесь, что все следующие компоненты успешно установлены:

    • Управление подключаемым модулем XR
    • Подключаемый модуль Windows XR
    • Вспомогатели ввода прежних версий XR
  2. Перейдите к разделу Edit > Project Settings (Правка > Параметры проекта).

  3. Щелкните вкладку Управление подключаемым модулем XR в окне Параметры проекта.

  4. Перейдите к параметрам универсальная платформа Windows и убедитесь, что в разделе Поставщики подключаемых модулей установлен флажок Windows Mixed Reality.

  5. Убедитесь, что установлен флажок Инициализировать XR при запуске.

  6. (Требуется для удаленного взаимодействия HoloLens в редакторе, в противном случае — необязательно) Перейдите к автономным параметрам и убедитесь, что в разделе Поставщики подключаемых модулей установлен флажок Windows Mixed Reality. Также убедитесь, что установлен флажок Initialize XR on Startup (Инициализировать XR при запуске).

    Управление подключаемым модулем XR с выбранной вкладкой

  7. (Необязательно) Щелкните вкладку Windows Mixed Reality в разделе Управление подключаемыми модулями XR и создайте настраиваемый профиль параметров, чтобы изменить значения по умолчанию. Если список параметров уже существует, профиль создавать не нужно.

    Управление подключаемым модулем XR с выбранной вкладкой Windows

Oculus

  1. Следуйте указаниям в руководстве По настройке Oculus Quest в MRTK с помощью конвейера пакета SDK для XR . В этом руководстве описаны шаги, необходимые для настройки Unity и MRTK для использования конвейера пакета SDK XR для Oculus Quest.

OpenXR

Важно!

OpenXR в Unity поддерживается только в Unity 2020.2 и более поздних версиях. Он также поддерживает только сборки x64, ARM и ARM64.

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

    1. Управление подключаемым модулем XR
    2. Подключаемый модуль OpenXR
    3. Подключаемый модуль OpenXR для Mixed Reality
  2. Перейдите в раздел Изменение > параметров проекта.

  3. Щелкните вкладку Управление подключаемым модулем XR в окне Параметры проекта.

  4. Убедитесь, что установлен флажок Инициализировать XR при запуске.

  5. (Необязательно) Если нацеливание HoloLens 2, убедитесь, что вы находитесь на платформе UWP, и выберите "Microsoft HoloLens группа компонентов".

  6. (Необязательно) Если выбран квест 2, убедитесь, что вы используете платформу Android, и выберите "Отслеживание рук" и "Поддержка метаквестов".

    Управление подключаемыми модулями OpenXR

Примечание

Если у вас уже есть проект, использующий MRTK из UPM, убедитесь, что следующая строка находится в файлеlink.xml , расположенном в папке MixedRealityToolkit.Generated.

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

Настройка MRTK для конвейера пакета SDK для XR

Используйте любой из профилей MRTK по умолчанию, которые настроены в конвейерах XR Unity. Предыдущие "DefaultOpenXRConfigurationProfile" и "DefaultXRSDKConfigurationProfile" теперь помечены как устаревшие.

При использовании OpenXR выберите "DefaultOpenXRConfigurationProfile" в качестве активного профиля или клонируйте его для внесения настроек.

При использовании других сред выполнения XR в конфигурации управления подключаемым модулем XR, например Windows Mixed Reality или Oculus, выберите "DefaultXRSDKConfigurationProfile" в качестве активного профиля или клонируйте его для внесения настроек.

При необходимости эти профили настраиваются с правильными системами и поставщиками. Дополнительные сведения о профилях и примерах поддержки пакета SDK для XR см. в документации по профилям .

Чтобы перенести существующий профиль в пакет SDK для XR, необходимо обновить следующие службы и поставщики данных.

Вы сможете увидеть новые поставщики данных на вкладке пакета SDK для XR в Unity 2019 или в представлении "main/только" в Unity 2020+, где устаревшая версия XR не существует.

Вкладка пакета SDK для XR

Камера

Добавление следующих поставщиков данных

Из расположения WindowsMixedReality.WindowsMixedRealityCameraSettings

Параметры камеры прежних версий

значение

Подключаемый модуль OpenXR Подключаемый модуль Windows XR
XRSDK.OpenXR.OpenXRCameraSettings XRSDK.WindowsMixedReality.WindowsMixedRealityCameraSettings
GenericXRSDKCameraSettings GenericXRSDKCameraSettings
Подключаемый модуль OpenXR Подключаемый модуль Windows XR
XRSDK.WindowsMixedReality.WindowsMixedRealityCameraSettings
GenericXRSDKCameraSettings GenericXRSDKCameraSettings

Параметры камеры пакета SDK для XR

Входные данные

Добавление следующих поставщиков данных

Из расположения WindowsMixedReality.Input.WindowsMixedRealityDeviceManager

Устаревшие параметры ввода

значение

Подключаемый модуль OpenXR Подключаемый модуль Windows XR
OpenXRDeviceManager XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

Параметры ввода OpenXR

Windows Mixed Reality:

Параметры входных данных пакета SDK для XR

Граница

Добавление следующих поставщиков данных

Из расположения MixedRealityBoundarySystem

Устаревшие параметры границ

значение

Подключаемый модуль OpenXR Подключаемый модуль Windows XR
XRSDKBoundarySystem XRSDKBoundarySystem

Параметры границ пакета SDK для XR

Отслеживание пространственного положения

Добавление следующих поставщиков данных

Подключаемый модуль OpenXR Подключаемый модуль Windows XR
XRSDK.OpenXR.OpenXRSpatialAwarenessMeshObserver (для UWP) XRSDK.WindowsMixedReality.WindowsMixedRealitySpatialMeshObserver (для UWP)
XRSDK.GenericXRSDKSpatialMeshObserver (для не UWP)
Подключаемый модуль OpenXR Подключаемый модуль Windows XR
XRSDK.GenericXRSDKSpatialMeshObserver XRSDK.WindowsMixedReality.WindowsMixedRealitySpatialMeshObserver

Параметры пространственной осведомленности пакета SDK для XR

Сопоставления контроллеров

Если вы используете настраиваемые профили сопоставления контроллеров, откройте один из них и запустите пункт меню Набор средств Смешанная реальность> — Служебные программы —> Обновление —> Профили сопоставления контроллеров, чтобы убедиться, что новые типы контроллеров пакета SDK для XR определены.

См. также раздел