Использование подключаемого модуля Опенкср в смешанной реальности для UnityUsing the Mixed Reality OpenXR Plugin for Unity

Начиная с Unity версии 2020,2, пакет подключаемого модуля Опенкср Microsoft Mixed Reality доступен с помощью диспетчера пакетов Unity (УПМ).Starting with Unity version 2020.2, Microsoft’s Mixed Reality OpenXR Plugin package is available using the Unity Package Manager (UPM).

Предварительные условияPrerequisites

  • Unity 2020,2 или более поздней версииUnity 2020.2 or later
  • Подключаемый модуль Unity Опенкср 0.1.2 или более поздней версииUnity OpenXR plugin 0.1.2 or later
  • Visual Studio 2019 или более поздней версииVisual Studio 2019 or later
  • Установка поддержки платформы UWP в Unity для приложений HoloLens 2Install UWP platform support in Unity for HoloLens 2 apps

Примечание

Если вы создаете приложения VR на компьютере с Windows, подключаемый модуль Опенкср в смешанной реальности не обязательно требуется.If you're building VR applications on Windows PC, the Mixed Reality OpenXR plugin is not necessarily required. Однако необходимо установить подключаемый модуль, если вы настраиваете сопоставление контроллера для контроллеров HP reverbа G2 или создаете приложения, которые работают на гарнитурах HoloLens 2 и VR.However, you'll want to install the plugin if you're customizing controller mapping for HP Reverb G2 controllers or building apps that work on both HoloLens 2 and VR headsets.

Установка подключаемого модуля Опенкср Mixed RealityInstalling the Mixed Reality OpenXR plugin

Перед использованием подключаемого модуля Опенкср Mixed Reality в проекте необходимо установить подключаемый модуль опенкср и пакеты управления подключаемым модулем XR .Your project needs to install the OpenXR Plugin and XR Plugin Management packages before using the Mixed Reality OpenXR Plugin. Если вы уже установили их, отлично!If you've already installed them, great! В противном случае Установка подключаемого модуля Опенкср для смешанной реальности автоматически установит их как зависимости:If not, installing the Mixed Reality OpenXR plugin will automatically install them as dependencies:

  1. В редакторе Unity выберите правка > параметры проекта > диспетчер пакетов .In the Unity Editor, navigate to Edit > Project Settings > Package Manager

  2. Разверните раздел реестра с областью действия , введите следующие сведения и выберите сохранить:Expand the Scoped Registries section, enter the following information, and select Save:

  3. В разделе Дополнительные параметры выберите включить предварительные версии пакетов .Under Advanced Settings, select Enable Preview Packages

Снимок экрана: окно диспетчера пакетов Unity, открываемое в параметрах проекта

Диспетчер пакетов Unity использует файл манифеста с именем manifest.js для определения устанавливаемых пакетов и реестров, из которых они могут быть установлены.The Unity Package Manager uses a manifest file named manifest.json to determine which packages to install and the registries they can be installed from.

Важно!

Опенкср по-прежнему является экспериментальным в Unity, и этот процесс может измениться со временем, так как мы работаем над оптимизацией процесса разработки.OpenXR is still experimental in Unity and this process may change over time as we work to optimize the developer experience.

Регистрация зависимости Mixed RealityRegistering the Mixed Reality dependency

После добавления реестра с областью действия Microsoft Mixed Reality в манифест можно указать пакет Опенкср.Once the Microsoft Mixed Reality scoped registry has been added to the manifest, the OpenXR package can be specified.

Чтобы добавить пакет Опенкср, выполните следующие действия.To add the OpenXR package:

  1. Откройте [прожектрут]/паккажес/manifest.js в текстовом редакторе, например Visual Studio CodeOpen [projectRoot]/Packages/manifest.json in a text editor like Visual Studio Code

    1. Чтобы получить его, щелкните правой кнопкой мыши пакеты на левой панели окна проекта.To get here, right click on Packages in the left panel of the Project window. Затем нажмите кнопку " отобразить в проводнике".Then, click Show in Explorer. Снимок экрана: список пакетов в окне проектаScreenshot of the packages listing in the Project window
  2. Измените раздел "зависимости" в файле packages/manifest.jsдля файла следующим образом:Modify the dependencies section of the Packages/manifest.json file as follows:

    Важно!

    В файле манифеста может быть больше зависимостей, чем показано здесь.There may be more dependencies in your manifest file than shown here. Не удаляйте ни один из них. просто добавьте в список зависимость Опенкср.Don't delete any of them, just add the OpenXR dependency to the list.

      "dependencies": {
        "com.microsoft.mixedreality.openxr": "0.1.2",
      }
    
  3. Сохраните файл, вернитесь в редактор Unity и откройте Диспетчер пакетов , чтобы убедиться, что подключаемый модуль установлен:Save the file, switch back to the Unity Editor, and open the Package Manager to confirm the plugin is installed:

    Снимок экрана: Диспетчер пакетов Unity открыт в редакторе Unity с выделенным подключаемым модулем Mixed Reality Опенкср

    Примечание

    Если пакет Опенкср удаляется с помощью диспетчера пакетов Unity, его необходимо добавить повторно с помощью описанных выше действий.If the OpenXR package is removed using the Unity Package Manager, you'll have to re-add it using the previously described steps.

Настройка управления подключаемым модулем XR для ОпенксрConfiguring XR Plugin Management for OpenXR

Чтобы задать Опенкср в качестве среды выполнения в Unity, сделайте следующее:To set OpenXR as the the runtime in Unity:

  1. В редакторе Unity перейдите к изменению > параметры проектаIn the Unity Editor, navigate to Edit > Project Settings
  2. В списке параметров выберите Управление подключаемым модулем XR .In the list of Settings, select XR Plugin Management
  3. Установите флажки инициализировать XR при запуске и опенкср (Предварительная версия) .Check the Initialize XR on Startup and OpenXR (Preview) boxes
  4. Если нацеливание на HoloLens 2, убедитесь, что вы находитесь на платформе UWP, и выберите набор функций Microsoft HoloLens .If targeting HoloLens 2, make sure you're on the UWP platform and select Microsoft HoloLens Feature Set

Снимок экрана: панель "Параметры проекта", открытая в редакторе Unity с выделенным подключаемым модулем управления XR

Важно!

Если рядом с подключаемым модулем опенкср (Предварительная версия) отображается красный значок предупреждения, щелкните значок и выберите исправить все перед продолжением.If you see a red warning icon next to OpenXR Plugin (Preview), click the icon and select Fix all before continuing. Для вступления изменений в силу может потребоваться перезапустить редактор Unity.The Unity Editor may need to restart itself for the changes to take effect.

Снимок экрана: окно проверки проекта Опенкср

Теперь вы готовы начать разработку с помощью Опенкср в Unity!You're now ready to begin developing with OpenXR in Unity! Перейдите к следующему разделу, чтобы узнать, как использовать примеры Опенкср.Continue on to the next section to learn how to use the OpenXR samples.

OptimizationOptimization

Если вы разрабатываете для HoloLens 2, перейдите к смешанной реальности> опенкср > применить Рекомендуемые параметры проекта для HoloLens 2 , чтобы получить лучшую производительность приложения.If you're developing for HoloLens 2, navigate to Mixed Reality> OpenXR > Apply recommended project settings for HoloLens 2 to get better app performance.

Снимок экрана: пункт меню "смешанная реальность", Открытый с выбранным Опенкср

Испытайте примеры сцен для UnityTry out the Unity sample scenes

Чтобы использовать один или несколько примеров, установите арфаундатион 4.0 + из диспетчера пакетов:To utilize one or more of the examples, install ARFoundation 4.0+ from the Package Manager:

Снимок экрана: Диспетчер пакетов Unity открыт в редакторе Unity с выделенным элементом управления AR Foundation

Примеры HoloLens 2HoloLens 2 samples

  1. В редакторе Unity перейдите к окну > диспетчер пакетов .In the Unity Editor, navigate to Window > Package Manager
  2. В списке пакетов выберите подключаемый модуль Опенкср Mixed Reality .In the list of packages, select Mixed Reality OpenXR Plugin
  3. Выберите пример в списке образцы и нажмите кнопку Импорт .Locate the sample in the Samples list and select Import

Снимок экрана: Диспетчер пакетов Unity открыт в редакторе Unity с выбранным подключаемым модулем смешанной реальности Опенкср и кнопка импорта выборки

Примечание

При обновлении пакета Unity предоставляет возможность обновления импортированных образцов.When a package is updated, Unity provides the option to update imported samples. При обновлении импортированного образца будут перезаписаны все изменения, внесенные в образец и связанные ресурсы.Updating an imported sample will overwrite any changes that have been made to the sample and associated assets.

Использование МРТК с поддержкой ОпенксрUsing MRTK with OpenXR support

МРТК Unity поддерживает подключаемый модуль Mixed Reality Опенкср, начиная с выпуска 2.5.3.MRTK Unity supports the Mixed Reality OpenXR plugin starting with the 2.5.3 release. Подключаемые модули МРТК можно установить из тех же реестров с заданной областью, что и при установке подключаемого модуля Опенкср Mixed Reality.MRTK plugins can be installed from the same scoped registries as you set up when installing the Mixed Reality OpenXR plugin. Более подробную информацию можно найти в документации по мртк.You can find more detailed information in the MRTK documentation.

  1. Добавьте следующие пакеты в файл [прожектрут]/паккажес/manifest.jsв файле:Add following packages in your [projectRoot]/Packages/manifest.json file:
"dependencies": {
    "com.microsoft.mixedreality.toolkit.foundation": "2.5.3",
    "com.microsoft.mixedreality.toolkit.tools": "2.5.3",
    "com.microsoft.mixedreality.toolkit.examples": "2.5.3",
    …
}
  1. Перейдите к скрипту компонента набора средств Микседреалити Toolkit в инспекторе и переключитесь в профиль дефаултопенксрконфигуратионпрофиле :Go to the MixedReality Toolkit component script in the Inspector and switch to the DefaultOpenXRConfigurationProfile profile:

Снимок экрана: переключение конфигурации МРТК в компоненте набора средств Mixed Reality в инспекторе

Известные проблемыKnown issues

При использовании функции отслеживания вручную добавьте следующую строку в файл Assets/микседреалититулкит. Generated/link.xml :When using the Hand Tracking feature, add following line in the Assets/MixedRealityToolkit.Generated/link.xml file:

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

Дальнейшие действияNext steps

Теперь, когда проект настроен для Опенкср и имеет доступ к примерам, ознакомьтесь с возможностями , которые в настоящее время поддерживаются в нашем подключаемом модуле опенкср.Now that you have your project configured for OpenXR and have access to samples, check out what features are currently supported in our OpenXR plugin.

Хотите оставить отзыв?Have Feedback?

Опенкср все еще экспериментально, поэтому мы будем рады получить отзывы, которые помогут улучшить его.OpenXR is still experimental, so we’d appreciate any feedback you can give us to help make it better. Вы найдете нас на форумах Unity , пометив сообщение на форуме с помощью Microsoft + опенкср и HoloLens 2 или Windows Mixed Reality.You'll find us on the Unity Forums by tagging your forum post with Microsoft + OpenXR and either HoloLens 2 or Windows Mixed Reality.

См. также статьюSee also