Настройка нового проекта OpenXR без MRTK

Статья
2023-03-21

Хотя корпорация Майкрософт и сообщество создали открытый код инструменты, такие как набор средств Смешанная реальность (MRTK), которые автоматически настраивают среду для смешанной реальности, некоторые разработчики могут пожелать создать свои возможности с нуля.

Другие параметры конфигурации, отличные от OpenXR, для рассмотрения

Windows XR: Корпорация Майкрософт не рекомендует использовать подключаемый модуль Windows XR для новых проектов в Unity 2020. Вместо этого следует использовать подключаемый модуль OpenXR Смешанная реальность. Однако если вы используете Unity 2019 и вам нужен AR Foundation 2.0 для совместимости с устройствами ARCore/ARKit, этот подключаемый модуль обеспечивает эту поддержку.

Устаревшая версия XR:

Если вы все еще находитесь в Unity 2019 или более ранней версии, корпорация Майкрософт рекомендует использовать поддержку устаревшей встроенной XR.

Если вы запускаете новый проект, рекомендуется установить Unity 2020 и использовать подключаемый модуль OpenXR Смешанная реальность.

Начало работы с OpenXR: создание проекта Unity

Запустите Unity Hub.
На вкладке Проекты щелкните Создать проект.
Щелкните раскрывающийся список Новый проект и выберите нужную версию редактора.
Выбранный шаблон должен представлять собой 3D Core.
В поле Имя проекта введите имя проекта, например, MRTK Tutorial.
В поле Расположение щелкните значок папки, а затем перейдите к папке, в которой необходимо сохранить проект, и выберите ее. Кроме того, можно создать новую папку.
Нажмите Создать проект. Откроется проект в Unity.

Внимание

При работе в Windows есть ограничение для MAX_PATH в 255 символов. Эти ограничения влияют на Unity. Может произойти сбой компиляции, если длина пути к файлу превышает 255 символов. Поэтому рекомендуется хранить проект Unity как можно ближе к корневому каталогу диска.

Настройка целевого объекта сборки

В строке меню выберите File>Build Settings... (Файл > Параметры сборки...).

Чтобы создать приложение для Windows Смешанная реальность, необходимо выбрать целевой объект сборки. Параметры сборки для универсальная платформа Windows (UWP) предназначены для любого устройства, включая иммерсивные гарнитуры, такие как HP Reverb G2. Это лучший выбор, если вы строите для HoloLens 2; Однако если вы используете виртуальную машину для настольных компьютеров, рекомендуется использовать автономную платформу ПК, Mac и Linux.
Выполните одно из следующих действий:

Если вы используете виртуальную реальность для настольных компьютеров, выполните следующие действия.
- Сохраните автономную платформу ПК, Mac и Linux , выбранную по умолчанию в новом проекте Unity:
Если вы нацелены на HoloLens 2:
- В разделе "Платформа" выберите универсальная платформа Windows. Убедитесь, что активны следующие параметры:
Тип сборки: проект D3D.

Целевая версия пакета SDK: последняя установленная версия.

Минимальная версия платформы 10.0.10240.0.

Версия Visual Studio: последняя установленная версия.
Нажмите кнопку Сменить платформу. При смене платформы Unity отображает индикатор выполнения.
По завершении процесса смены платформы закройте окно Параметры сборки.

Скачивание и установка средства компонента Смешанная реальность

Подключаемый модуль OpenXR Смешанная реальность поставляется в виде пакета для Unity. Лучший способ обнаружения, обновления и импорта пакетов компонентов — с помощью средства Смешанная реальность компонентов. Вы можете искать пакеты по имени или категории, просматривать их зависимости и проверять предлагаемые изменения в файле манифеста проектов перед импортом.

Скачайте последнюю версию средства Mixed Reality Feature Tool из Центра загрузки Майкрософт.
После завершения скачивания перейдите к исполняемому файлу MixedRealityFeatureTool.exe, а затем используйте его для запуска средства компонента Смешанная реальность.

Импорт подключаемого модуля OpenXR Смешанная реальность

В Mixed Reality Feature Tool выберите Start.
Нажмите кнопку "Обзор" (это кнопка "три точки" на изображении ниже), а затем перейдите к папке, содержащей проект Unity, и откройте ее.

Примечание.

Поле Project Path (Путь проекта) в средстве должно содержать какое-либо значение, поэтому по умолчанию вставляется обратная косая черта ("_").

После выбора папки средство проверяет, является ли она допустимой папкой проекта Unity.
Выберите Discover Features (Обнаружение компонентов).

Примечание. Может потребоваться подождать несколько секунд, пока средство обновит пакеты из каналов.
На странице Discover Features обратите внимание на то, что имеется список из шести групп пакетов.
Нажмите кнопку "+" слева от элемента Platform Support (0 of 5) и выберите последнюю версию Mixed Reality OpenXR Plugin.
Выполнив выбор, щелкните Get Features (Получить компоненты).
Выберите Validate (Проверить), чтобы проверить выбранные пакеты. Вы увидите диалоговое окно с текстом No validation issues were detected (Проблемы при проверке не обнаружены). После этого щелкните ОК.
На странице Import Features (Импорт компонентов) в левом столбце в списке Components (Компоненты) отображаются только что выбранные пакеты. В правом столбце Required dependencies (Обязательные зависимости) нет ни одной зависимости. Чтобы узнать больше о них, щелкните ссылку Details (Сведения) для любого из этих элементов.
Когда вы будете готовы продолжить, выберите Import (Импорт). На странице Review and Approve (Проверка и утверждение) можно просматреть сведения о пакетах.
Выберите Утвердить.
Вернитесь в редактор Unity и щелкните пустую область в пользовательском интерфейсе. Появится индикатор выполнения, показывающий, что пакет импортируется.

Настройка параметров серверной части ввода

После импорта пакета Unity появится предупреждение о том, нужно ли включить серверные части, перезагрузив редактор. Выберите Да.

Настройка проекта для HoloLens 2 с помощью проверки проекта (MR OpenXR 1.6+)

Если вы разрабатываете для классической виртуальной реальности, пропустите этот раздел и перейдите к разделу "Настройка проекта для классической виртуальной реальности".

В строке меню щелкните Смешанная реальность > Параметры > проверки проекта HoloLens 2 (UWP), чтобы включить правила проверки для HoloLens 2. Для подключаемых модулей MR OpenXR до версии 1.9 доступны пункт меню Смешанная реальность > Project > Apply рекомендуемые параметры проекта для HoloLens 2.
В всплывающем окне проверки проекта убедитесь, что вы находитесь на вкладке платформы UWP (на логотипе Windows) и нажмите кнопку "Исправить все ", чтобы устранить проблемы с проверкой. Обратите внимание, что могут возникнуть проблемы, которые остаются после нажатия кнопки "Исправить все". В этом случае попробуйте снова нажать кнопку "Исправить все ", игнорировать все проблемы, помеченные как "сцена конкретной" (если таковые имеются), и идти по остальным проблемам (если таковые имеются), чтобы узнать, есть ли какие-либо предлагаемые изменения, которые вы хотите внести.
Проект почти готов к развертыванию HoloLens 2 на этом этапе. Перейдите к настройке параметров проигрывателя для следующего шага.

Настройка проекта для HoloLens 2 вручную

Убедитесь, что окно параметров проекта открыто. Если нет, в строке меню выберите "Изменить>параметры проекта".
В окне "Параметры проекта" убедитесь, что вы находитесь на странице управления подключаемым модулем XR и на вкладке универсальная платформа Windows.
Убедитесь, что выбран параметр инициализация XR при запуске , а затем в разделе "Поставщики подключаемых модулей" нажмите кнопку OpenXR.
Подключаемый модуль OpenXR загружается, а затем под OpenXR отображаются несколько элементов. Выберите группу функций Microsoft HoloLens.

Обратите внимание, что рядом с OpenXR есть желтый треугольник предупреждения. Это означает, что у вас есть несовместимые параметры, которые необходимо устранить. Чтобы узнать, как устранить эту проблему, пропустите следующий раздел о настройке виртуальной реальности и перейдите к следующему разделу, чтобы устранить несовместимые параметры.

Настройка проекта для классической виртуальной реальности с помощью проверки проекта (MR OpenXR 1.9+)

В строке меню щелкните Смешанная реальность > Параметры > проверки проекта Win32 (автономное приложение), чтобы включить правила проверки для классического приложения XR.
Во всплывающем окне проверки проекта убедитесь, что вы находитесь на вкладке автономной платформы и нажмите кнопку "Исправить все ", чтобы устранить проблемы с проверкой. Обратите внимание, что могут возникнуть проблемы, которые остаются после нажатия кнопки "Исправить все". В этом случае попробуйте снова нажать кнопку "Исправить все ", игнорировать все проблемы, помеченные как "сцена конкретной" (если таковые имеются), и идти по остальным проблемам (если таковые имеются), чтобы узнать, есть ли какие-либо предлагаемые изменения, которые вы хотите внести.

Настройка проекта для классической виртуальной реальности вручную

Убедитесь, что окно параметров проекта открыто. Если нет, перейдите в строку меню, выберите "Изменить>параметры проекта".
В окне параметров проекта убедитесь, что вы находитесь на странице управления подключаемым модулем XR и на вкладке "Автономный компьютер Mac и Linux".
Убедитесь, что выбран параметр инициализация XR при запуске , а затем в разделе "Поставщики подключаемых модулей" нажмите кнопку OpenXR.
Загрузится подключаемый модуль OpenXR, а затем в разделе OpenXR появятся два элемента. Выберите первую группу компонентов Windows Смешанная реальность.

Обратите внимание, что рядом с OpenXR появился желтый треугольник предупреждения. Это означает, что у вас есть несовместимые параметры, которые необходимо устранить. Чтобы узнать, как устранить эту проблему, перейдите к следующему разделу, чтобы устранить несовместимые параметры.

Разрешение несовместимых параметров

Внимание

Изображения в этом разделе отображают параметры на вкладке универсальная платформа Windows. Однако инструкции одинаковы для вкладки виртуальной реальности для рабочего стола, за исключением того, где указано.

Наведите указатель мыши на желтый треугольник предупреждения рядом с OpenXR, а затем прочитайте сообщение во всплывающем ведении, а затем выберите треугольник.
В окне OpenXR Project Validation (Проверка проекта OpenXR) указано несколько проблем. Нажмите кнопку Fix All (Исправить все). ПРИМЕЧАНИЕ. Этот список может выглядеть по-разному в зависимости от того, в какой вкладке вы находитесь.
Одна из проблем останется — необходимо добавить по крайней мере один профиль взаимодействия. Для этого щелкните Edit (Изменить). Откроется раздел параметров подключаемого модуля OpenXR в окне Project Settings (Параметры проекта).
В области Interaction Profiles (Профили взаимодействия) обратите внимание на кнопку со знаком "плюс" (+).
Нажмите кнопку три раза, каждый раз выбирая другой профиль:

Eye Gaze Interaction Profile (Профиль взаимодействия с помощью взгляда);

Microsoft Hand Interaction Profile (Профиль взаимодействия с помощью рук Майкрософт);

Microsoft Motion Controller Profile (Профиль контроллера движений Майкрософт).

Если рядом с Eye Gaze Interaction Profile или любым другим профилем появится желтый треугольник, выберите треугольник, а затем в окне OpenXR Project Validation нажмите кнопку Fix (Исправить). Завершив работу, закройте окно OpenXR Project Validation.
В окне Project Settings (Параметры проекта) в разделе OpenXR Feature Groups (Группы функций OpenXR) убедитесь, что выбраны следующие компоненты:

Если вы находитесь на вкладке Виртуальной реальности для настольных компьютеров:

Windows Mixed Reality

Отслеживание рук

Motion Controller Model (Модель контроллера движений)

Если вы находитесь на вкладке универсальная платформа Windows:

Microsoft HoloLens

Отслеживание рук

Motion Controller Model (Модель контроллера движений)
Щелкните раскрывающийся список Depth Submission Mode (Режим отправки глубины), а затем выберите Depth 16 Bit (Глубина 16 бит).

Совет

Уменьшение формата глубины до 16-разрядной версии не является обязательным, однако это может повысить производительность графики в проекте. Подробные сведения приведены в разделе Совместное использование буфера глубины (HoloLens).

Примечание.

Параметр Render Mode (Режим рендеринга), находящийся непосредственно над параметром Depth Submission Mode, по умолчанию равен Single Pass Instanced (Один проход). В приложениях смешанной реальности сцена отображается дважды, один раз для каждого глаза. Результат — стереоскопичность. Это удваивает объем необходимых вычислений, поэтому важно выбрать наиболее эффективный путь отрисовки в Unity, чтобы сэкономить время ЦП и GPU. В этом случае лучшим вариантом является визуализация в один проход — рекомендуется включить ее по умолчанию для каждого проекта. Дополнительные сведения см. в документации по Unity.

Настройка параметров проигрывателя

В левом столбце Project Settings (Параметры проекта) выберите Player (Проигрыватель).
Обратите внимание, что в окне проигрывателя поле "Имя продукта" уже заполнено. Оно взято из имени проекта и будет отображаться в меню HoloLens.

Совет

Чтобы упростить поиск приложения во время разработки, добавьте символ подчеркивания перед именем, чтобы отсортировать его в верхней части списка.
Щелкните раскрывающийся список "Параметры публикации", а затем в поле "Имя пакета" введите подходящее имя.

Примечание.

Имя пакета — это уникальный идентификатор приложения. Если вы хотите избежать перезаписи ранее установленных версий приложения с тем же именем, необходимо изменить этот идентификатор перед развертыванием приложения.
Закройте окно Project Settings (Параметры проекта).

Теперь вы готовы начать разработку с OpenXR в Unity!

Примеры проектов Unity

Ознакомьтесь с репозиторием примеров Смешанная реальность OpenXR для примеров проектов unity, демонстрирующих создание приложений Unity для HoloLens 2 или Смешанная реальность гарнитур с помощью подключаемого модуля OpenXR Смешанная реальность.