Начало работы с 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 при запуске).

   

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

   

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, и выберите "Отслеживание рук" и "Поддержка метаквестов".

   

Примечание

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

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

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

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

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

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

Камера

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

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

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

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

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

OpenXR:

Windows Mixed Reality:

Граница

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

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

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

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

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

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

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

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

• Начало работы с разработкой дополненной реальности в Unity
• Начало работы с разработкой виртуальной реальности в Unity