Развертывание на HoloLens и гарнитурах WMR — MRTK2

Существует два способа развертывания приложений, созданных с помощью MRTK на устройстве с Windows, Univeral Windows Platform (UWP) и изолированной платформы. Приложения, созданные для HoloLens 1 или HoloLens 2, должны ориентироваться на UWP, а приложения, созданные для гарнитур WMR, могут быть предназначены как для UWP, так и для автономной платформы.

Создание и развертывание MRTK для HoloLens 1, HoloLens 2 и гарнитур WMR (UWP)

Инструкции по сборке и развертыванию для HoloLens 1 и HoloLens 2 (UWP) можно найти при создании приложения на устройстве. Эти действия также позволяют развертывать гарнитуры WMR.

Примечание

При развертывании приложения на устройстве в Visual Studio необходимо настроить Visual Studio немного по-разному в зависимости от устройства. Конфигурации приведены ниже.

Платформа Конфигурация Архитектура Назначение
HoloLens 2 Выпуск или главный выпуск ARM64 Устройство
HoloLens 1 Выпуск или главный выпуск x86 Устройство
Гарнитуры WMR Выпуск или главный выпуск X64 Локальный компьютер

Совет: При сборке для HoloLens 1, HoloLens 2 или WMR рекомендуется использовать параметры сборки "Целевая версия пакета SDK" и "Минимальная версия платформы", как показано на рисунке ниже.

Build window

Другие параметры могут отличаться (например, конфигурация сборки, архитектура или тип сборки), а некоторые из них вы всегда можете изменить в решении Visual Studio.

Убедитесь, что раскрывающийся список "Target SDK Version" (Целевая версия пакета SDK) содержит вариант "10.0.18362.0". Если он отсутствует, необходимо установить последнюю версию Windows SDK.

Unity 2019/2020 и HoloLens

Если приложение HoloLens отображается в виде 2D-панели на устройстве, перед развертыванием приложения UWP убедитесь, что в Unity настроены следующие параметры:

Если используется устаревшая встроенная поддержка XR (только Unity 2019):

  1. Перейдите к разделу "Изменить > Project Параметры", "Проигрыватель"
  2. В разделе XR Settings (Параметры смешанной реальности) на вкладке UWP убедитесь, что включен параметр Virtual Reality Supported (Поддержка виртуальной реальности), а в список пакетов SDK добавлен SDK Windows Mixed Reality.
  3. Выполните сборку и развертывание в Visual Studio.

При использовании OpenXR или Windows подключаемых модулей XR:

  1. Выполните шаги, описанные в статье Начало работы с XRSDK.
  2. Убедитесь, что DefaultXRSDKConfigurationProfile выбран в качестве профиля конфигурации.
  3. Перейдите к разделу "Изменить > Project Параметры", XR-Plugin "Управление" и убедитесь, что Windows Mixed Reality включен.
  4. Выполните сборку и развертывание в Visual Studio.

Важно!

При использовании Unity 2019.3.x в качестве архитектуры сборки в Visual Studio выберите ARM64, а не ARM. При стандартных параметрах Unity для версии Unity 2019.3.x из-за ошибки Unity приложение Unity не сможет развернуться на HoloLens, если выбрана архитектура ARM.

Если требуется архитектура ARM, перейдите к разделу "Изменить > Project Параметры", "Проигрыватель" и в меню "Другие Параметры" отключите задания графики. Отключение параметра Graphics Jobs (Графические задания) позволит развернуть приложение с архитектурой сборки ARM в Unity 2019.3.x, но мы рекомендуем использовать ARM64.

Эта проблема устранена в Unity 2019.4 и Unity 2020.3.

Создание и развертывание MRTK в гарнитурах WMR (автономная версия)

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

Примечание

Пакет SDK XR для Unity также имеет встроенную поддержку Windows Mixed Reality в автономных сборках, но не требует наличия подключаемого модуля SteamVR или Windows Mixed Reality. Описанные здесь действия обязательны для выполнения в устаревшей версии XR в Unity.

  1. Установите Steam.
  2. Установите SteamVR.
  3. Установите подключаемый модуль Windows Mixed Reality.

Использование подключаемого модуля Windows Mixed Reality

  1. Откройте Steam и найдите подключаемый модуль Windows Mixed Reality.

    • Перед запуском подключаемого модуля Windows Mixed Reality обязательно закройте SteamVR. Запуск подключаемого модуля Windows Mixed Reality автоматически запускает SteamVR.
    • Убедитесь, что подключена гарнитура Windows Mixed Reality.

    WMR Plugin Search

  2. Выберите Launch (Запустить) для подключаемого модуля Windows Mixed Reality для SteamVR.

    WMR Plugin

  3. В Unity откройте сцену MRTK, перейдите к разделу "Сборка файлов>" Параметры

  4. Выполните сборку сцены:

    • Щелкните Add Open Scene (Добавить открытую сцену).
    • Убедитесь, что для параметра Platform (Платформа) выбран вариант Standalone (Автономная).
    • Щелкните Build (Выполнить сборку).
    • Выберите расположение для новой сборки в проводнике.

    Build Settings for Standalone

  5. Будет создан новый исполняемый файл Unity, который нужно выбрать в проводнике, чтобы запустить приложение.

    File Explorer Unity

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