Начало работы с OpenXR

  • Статья

Вы можете разрабатывать приложения, используя OpenXR с HoloLens 2 или иммерсивную гарнитуру Windows Mixed Reality с компьютером. Если у вас нет доступа к гарнитуре, можно использовать эмулятор HoloLens 2 или симулятор Windows Mixed Reality.

Начало работы с OpenXR для HoloLens 2

Чтобы начать разработку приложений OpenXR для HoloLens 2:

  1. Настройте устройство HoloLens 2 или установите последнюю версию эмулятора HoloLens 2.

Вот и все! Среда выполнения API OpenXR предварительно установлена на HoloLens 2 устройствах, и вы будете получать автоматические обновления через Магазин.

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

Примечание

Если вы используете эмулятор, образ эмулятора будет сбрасываться при каждом запуске, поэтому лучше всего убедиться, что у вас установлена последняя версия образа эмулятора HoloLens 2.

Начало работы с OpenXR для гарнитур Windows Mixed Reality

Чтобы приступить к разработке приложений OpenXR для иммерсивных Windows Mixed Reality гарнитур, выполните приведенные далее действия.

  1. Убедитесь, что вы используете по крайней мере обновление Windows 10 за октябрь 2020 г. (20H2), которое является минимальным поддерживаемым выпуском ОС для Windows Mixed Reality конечных пользователей для запуска приложений OpenXR. Более ранние версии Windows 10 по-прежнему должны работать с OpenXR, но могут не иметь идеальной производительности или качества. Если вы используете более раннюю версию Windows 10, вы можете выполнить обновление с помощью помощника по обновлению Windows 10.
  2. Настройте гарнитуру Windows Mixed Reality или включите симулятор Windows Mixed Reality.

Вот и все! Среда выполнения Windows Mixed Reality OpenXR устанавливается и активна автоматически для всех пользователей Windows Mixed Reality. Затем Microsoft Store поддерживает среду выполнения в актуальном состоянии.

Если вы использовали несколько гарнитур виртуальной реальности на компьютере, помните, что активная среда выполнения OpenXR может быть изменена системным программным обеспечением другого поставщика. Чтобы повторно активировать Windows Mixed Reality OpenXR Runtime, в меню Пуск запустите "портал Смешанная реальность", а затем выберите "Исправить" в верхней части окна. Если эта кнопка отсутствует, среда выполнения OpenXR уже активна.

Получение средств OpenXR для Windows Mixed Reality

Если вы разрабатываете приложения OpenXR для HoloLens 2 или виртуальной реальности для ПК, вам может пригодиться это приложение Средств OpenXR для Windows Mixed Reality. Он содержит демонстрацию различных функций OpenXR и страницу среды выполнения OpenXR, содержащую ключевые сведения об активной среде выполнения и текущей гарнитуре.

Чтобы найти и установить приложение OpenXR Tools, на HoloLens 2 перейдите в приложение Магазина и найдите "OpenXR".

При использовании эмулятора HoloLens 2 проще всего установить средства OpenXR для Windows Mixed Reality с помощью портала устройств Windows. На портале перейдите на страницу OpenXR, а затем в разделе Компоненты разработчика нажмите кнопку Установить . Это также работает на физических HoloLens 2 устройствах.

Средства OpenXR для приложения Windows Mixed Reality

Изучение API OpenXR и примера приложения

Не забудьте установить средства, необходимые для разработки OpenXR, если вы еще этого не сделали.

В проекте BasicXrApp показан простой пример OpenXR с файлами проекта Win32 и UWP HoloLens 2 в Visual Studio. Так как решение содержит проект UWP HoloLens, для его полного открытия потребуется рабочая нагрузка разработки универсальная платформа Windows, установленная в Visual Studio.

Хотя файлы проектов Win32 и UWP разделены из-за различий в упаковке и развертывании, код приложения в каждом проекте почти одинаковый.

Для обзора API OpenXR проверка этот 60-минутный видеоролик с примером BasicXrApp в Visual Studio. В видео показано, как каждый из основных компонентов API OpenXR можно использовать в собственном обработчике, а также демонстрируется некоторые приложения, созданные на основе OpenXR.

Запуск приложения OpenXR

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

После создания пакета приложения UWP OpenXR его можно развернуть на устройстве HoloLens 2 или в эмуляторе HoloLens 2.

Использование OpenXR в существующем проекте

Чтобы приступить к работе с OpenXR в существующем проекте, включите загрузчик OpenXR. Загрузчик обнаруживает активную среду выполнения OpenXR на устройстве и предоставляет доступ к основным функциям и функциям расширений, которые он реализует.

Вы можете сослаться на официальный пакет NuGet OpenXR из проекта Visual Studio или включить официальный источник загрузчика OpenXR из репозитория GitHub Khronos. Любой из этих подходов предоставит вам доступ к основным функциям OpenXR 1.0, а также к опубликованным KHRрасширениям и EXTMSFT .

Если вы также хотите поэкспериментировать с MSFT_preview расширениями, можно скопировать заголовки OpenXR в предварительной версии из репозитория Смешанная реальность GitHub.

Ссылка на официальный пакет NuGet OpenXR

Пакет NuGet OpenXR.Loader — это самый простой способ сослаться на предварительно созданный загрузчик OpenXR .DLL в решении Visual Studio C++. Это даст вам доступ к основным функциям OpenXR 1.0, а также к опубликованным KHRрасширениям и EXTMSFT .

Чтобы добавить ссылку на пакет NuGet OpenXR.Loader в решение Visual Studio C++, выполните указанные ниже действия.

  1. В Обозреватель решений щелкните правой кнопкой мыши проект, который будет использовать OpenXR, и выберите Управление пакетами NuGet....
  2. Перейдите на вкладку Обзор и найдите OpenXR.Loader.
  3. Выберите пакет OpenXR.Loader и щелкните Установить в области сведений справа.
  4. Нажмите кнопку ОК, чтобы принять изменения в проекте.
  5. Добавьте #include <openxr/openxr.h> в исходный файл, чтобы начать использовать API OpenXR.

Чтобы просмотреть пример API OpenXR в действии, проверка пример приложения BasicXrApp.

Включить официальный источник загрузчика OpenXR

Если вы хотите создать загрузчик самостоятельно, например, чтобы избежать дополнительных .DLL загрузчика, вы можете извлечь официальные источники загрузчика OpenXR Khronos в свой проект. Это даст вам доступ к основным функциям OpenXR 1.0, а также к опубликованным KHRрасширениям и EXTMSFT .

Чтобы приступить к работе, следуйте инструкциям в репозитории Khronos OpenXR-SDK на сайте GitHub. Проект настроен для сборки с помощью CMake. Если вы используете MSBuild, вам потребуется скопировать код в собственный проект.

Использование предварительных версий расширений

Расширения MSFT_preview , перечисленные в стратегии расширения , являются экспериментальными расширениями поставщиков, которые предварительно просматриваются для сбора отзывов. Эти расширения предназначены только для устройств разработчика и будут удалены при наличии реального расширения.

Если вы хотите опробовать доступные MSFT_preview расширения, выполните следующие действия, чтобы обновить проект.

  1. Выполните любой из приведенных выше подходов, чтобы интегрировать загрузчик OpenXR в проект.
  2. Замените стандартные заголовки OpenXR в проекте заголовками предварительного просмотра из репозитория Смешанная реальность OpenXR на GitHub.

Чтобы активировать поддержку расширений предварительной версии на целевом HoloLens 2 или настольном компьютере, выполните приведенные далее действия.

  1. Чтобы убедиться, что у вас установлена последняя версия среды выполнения OpenXR со всеми расширениями , запустите приложение Store на целевом устройстве или эмуляторе, откройте меню в правом верхнем углу, выберите Загрузки и обновления и выберите Получить обновления.
  2. Установите приложение OpenXR Tools for Windows Mixed Reality из Microsoft Store на целевое устройство и запустите его.
  3. Перейдите на вкладку Параметры и включите параметр Использовать последнюю предварительную версию среды выполнения OpenXR. Это позволит включить предварительную версию среды выполнения на устройстве с активированными расширениями предварительной версии. Вкладка
  4. Убедитесь, что версия среды выполнения, показанная на вкладке Среда выполнения OpenXRинструментов OpenXR, для Windows Mixed Reality соответствует требуемой версии расширений предварительной версии, которые вы планируете попробовать. В этом случае расширение должно появиться в списке Расширения . Когда доступно стабильное расширение, его предварительная версия будет удалена.
    Вкладка OpenXR Tools for Windows Mixed Reality Приложение OpenXR Runtime

Документацию по этим предварительным версиям расширений и примеры их использования см. в репозитории Смешанная реальность OpenXR.

Устранение неполадок

Если у вас возникли проблемы при запуске разработки OpenXR, проверка наши советы по устранению неполадок.