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

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

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

Конвейер пакета SDK для XR в настоящее время поддерживает три платформы: 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 установлен в разделе "Поставщики подключаемых модулей". Также убедитесь, что установлен флажок инициализации 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 набор компонентов

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

Примечание

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

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

Примечание

Для первоначального выпуска MRTK и OpenXR поддерживаются только HoloLens 2 сформулированные руки и Windows Mixed Reality контроллеры движения. Поддержка дополнительного оборудования будет добавлена в предстоящих выпусках.

Настройка 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 или в основном /единственном представлении в 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.

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