Начальная настройка для MRTK3

Представляем общедоступную предварительную версию MRTK3. Так как MRTK3 — это коллекция слабо связанных пакетов, использование MRTK3 отличается от использования MRTK 2.x. Мы не предлагаем MRTK в качестве проекта Unity, поэтому вам потребуется использовать наш шаблон проекта, который предварительно настроен для взаимодействия со всеми пакетами MRTK (с ним проще приступить к работе), или начать с нового проекта (рекомендованный вариант, расширяющий возможности для управления).

Использовать каждый пакет MRTK не обязательно. Узнайте, какие функции вам пригодятся, и добавьте только необходимые зависимости.

Установка инструментов

Перед началом работы убедитесь, что у вас есть все инструменты, указанные по этой ссылке:

Примечание

Перед выбором версии Unity обязательно ознакомьтесь с известными проблемами в некоторых версиях Unity.

Путь 1. Клонируйте репозиторий и попробуйте поработать с примером проекта Unity

Самый простой способ получить доступ к MRTK3 и испытать это решение в действии — воспользоваться предварительно настроенным проектом со ссылками на все текущие пакеты MRTK3. Клонируйте наш проект из репозитория GitHub и извлеките ветвь mrtk3. После этого вы можете просто запустить Unity (2020.3.33f1 или более поздней версии) в проекте MRTKDevTemplate в UnityProjects и поэкспериментировать с примерами сцен в редакторе путем удаленного взаимодействия или развертывания на устройствах.

Сведения о примерах сцен, включенных в предварительную версию, см. в разделе Использование и создание сцен.

Путь 2. Добавление MRTK3 в новый проект Unity

1. Создайте проект Unity

Создайте проект Unity в Unity 2020.3.35f1 или более поздней версии либо Unity 2021.3.4f1 или более поздней версии. Закройте проект Unity, прежде чем переходить к следующему шагу.

2. Импортируйте необходимые зависимости и пакеты MRTK3 с помощью Mixed Reality Feature Tool

MRTK3 использует несколько пакетов, которые не включены в эту предварительную версию. Для их получения используйте Mixed Reality Feature Tool и выберите последние версии следующих компонентов на этапе обнаружения компонентов:

  • Platform Support (Поддержка платформы) → Mixed Reality OpenXR Plugin (Плагин Mixed Reality OpenXR)
  • Spatial Audio (Пространственный звук) → Microsoft Spatializer (необязательно)

Для пакетов MRTK3 мы настоятельно рекомендуем использовать следующие два пакета, которые помогут вам быстро приступить к работе:

  • MRTK3 → MRTK Input (требуется для этой установки);
  • MRTK3 → MRTK UX Components.

Эти два пакета, наряду с их зависимостями (автоматически добавленными Feature Tool), позволит вам изучить большинство наших предложений пользовательского интерфейса и создавать проекты, готовые к развертыванию на различных устройствах XR. Учитывайте, что вы всегда можете вернуться к Feature Tool и позднее добавить в проект дополнительные пакеты.

Примечание

Дополнительные сведения о пакетах MRTK3 см. на странице обзора пакетов.

Выбрав пакеты, нажмите кнопку Get features (Получить компоненты) и следуйте инструкциям в Mixed Reality Feature Tool, чтобы импортировать выбранные пакеты в проект Unity.

3. Соберите проекта Unity

Откройте проект Unity и дождитесь, пока завершится импорт добавленных пакетов. В ходе этого процесса может появиться два всплывающих окна:

  1. В первом окне вам будет предложено включить новую серверную часть ввода. Выберите yes (Да).
  2. Во втором окне вам будет предложено обновить XR InteractionLayerMask. Выберите No Thanks (Нет, не нужно).

Unity может перезапуститься несколько раз во время этого процесса — дождитесь его завершения, прежде чем продолжить.

4. Настройте профиль MRTK после импорта

После импорта MRTK3 необходимо настроить профиль для автономного режима и каждой дополнительной целевой платформы.

  1. Последовательно выберите Edit > Project Settings (Правка > Параметры проекта).

  2. В разделе Project Параметры (Параметры проекта) перейдите к MRTK3 и откройте вкладку Standalone (Автономный режим). Обратите внимание, что профиль изначально не указан.

  3. Укажите в поле профиль MRTK по умолчанию, который входит в состав основного пакета. Вы можете ввести ключевое слово MRTKprofile в строке поиска в окне проекта. Обязательно выберите поиск в All. Профиль также можно найти в разделе Packages/com.microsoft.mrtk.core/Configuration/Default Profiles/MRTKProfile.asset.

    Примечание

    На снимке экрана ниже показаны не все подсистемы MRTK. Ваш список подсистем MRTK может быть другим в зависимости от добавленных в проект пакетов MRTK3.

    Назначение профиля MRTK по умолчанию

  4. На вкладках других целевых объектов сборки, которые вы хотите использовать (например, UWP, Android), проверьте, назначен ли профиль. В противном случае повторите предыдущий шаг на соответствующей вкладке.

Если ваше целевое устройство — XR, например HoloLens 2 или Quest, после импорта MRTK3 в OpenXR требуется настроить ряд параметров.

Примечание

Инструкции ниже относятся к гарнитурам HoloLens 2 и WMR. Если ваше целевое устройство — Quest, ознакомьтесь с инструкциями на странице развертывания для Quest.

  1. Последовательно выберите Edit > Project Settings (Правка > Параметры проекта).

  2. В разделе Project Settings (Параметры проекта) перейдите в подраздел XR Plug-in Management (Управление подключаемым модулем XR) и включите OpenXR на вкладках Standalone (Автономный режим) и UWP. На каждой вкладке выберите параметр Initialize XR on Startup (Инициализировать XR при запуске) и включите группу компонентов Windows Mixed Reality (Смешанная реальность Windows) для автономного режима и Microsoft HoloLens для UWP.

    Примечание

    После установки флажка OpenXR может появиться желтый значок предупреждения. Щелкните этот значок, чтобы открыть средство проверки проектов OpenXR. Щелкните Fix All (Исправить все) и пропустите проблему с профилем взаимодействия, которую невозможно исправить автоматически. Профили будут добавлены на шаге ниже.

    Для автономного режима:

    Окно управления подключаемого модуля Standalone XR

    Для UWP:

    Окно управления подключаемого модуля UWP XR

  3. В разделе Project Setting (Параметры проекта) выберите XR Plug-in Management (Управление подключаемым модулем XR) > OpenXR > Interaction Profiles (Профили взаимодействия) и добавьте следующие три профиля для UWP и автономного режима:

    • Eye Gaze Interaction Profile (Профиль взаимодействия с помощью взгляда);
    • Microsoft Hand Interaction Profile (Профиль взаимодействия с помощью рук Майкрософт);
    • Microsoft Motion Controller Profile (Профиль контроллера движений Майкрософт).

    Примечание

    Чтобы избавиться от предупреждения (знака желтого треугольника), может потребоваться использовать средство проверки проектов OpenXR.

    Примечание

    Чтобы избавиться от предупреждения (знака желтого треугольника), может потребоваться использовать средство проверки проектов OpenXR.

    Для автономного режима:

    Standalone OpenXR

    Для UWP:

    UWP OpenXR

  4. В HoloLens 2 рекомендуется задать для параметра Depth Submission Mode (Режим глубины при отправке) значение 16-разрядной глубины. Для иммерсивных гарнитур можно использовать отправку с 24-разрядной глубиной. Дополнительные сведения см. в документации Майкрософт по разработке для Unity.

6. Поздравляем, настройка проекта завершена!

Переходите к созданию сцены MRTK3.

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