Поделиться через


Начиная с нового проекта

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

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

Настройка нового проекта Unity с помощью MRTK3

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

Создайте проект Unity с Unity 2021.3.21f1 или более поздней версии. Закройте проект 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. Вы всегда можете вернуться к средству создания компонентов и позже добавить в проект дополнительные пакеты.

Не забудьте выбрать org.mixedrealitytoolkit.* пакеты, а не устаревшие пакеты. Пакеты com.microsoft.mrtk.* устарели и больше не поддерживаются.

Выбор пакетов MRTK3 по умолчанию в средстве microsoft Смешанная реальность Feature Tool

Примечание

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

Завершив выбор пакетов, щелкните Получить компоненты, а затем следуйте инструкциям в Смешанная реальность Feature Tool, чтобы импортировать выбранные пакеты в проект Unity.

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

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

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

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

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

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

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

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

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

    Примечание

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

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

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

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

Примечание

Инструкции ниже относятся к гарнитурам HoloLens 2 и WMR. Если вы нацелены на 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 . Щелкните Исправить все и игнорируйте проблему профиля взаимодействия, которая не может быть исправлена автоматически. Профили будут добавлены на шаге ниже.

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

    Окно управления подключаемого модуля 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. Некоторые предупреждения можно устранить вручную:
    1. В разделе Параметры проекта перейдите к разделу Разрешение проигрывателя > и презентация. Убедитесь, что флажок Запуск в фоновом режиме снят.
    2. Для UWP в разделе Возможности параметров публикации проигрывателя > убедитесь, что установлены флажки >WebCam, Microphone, SpatialPerception и GazeInput, если эти функции необходимы приложению. Дополнительные сведения о возможностях приложений Windows см. в разделе Объявления возможностей приложений.

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

    Standalone OpenXR

    Для UWP:

    UWP OpenXR

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

  5. Для иммерсивных гарнитур можно использовать отправку с 24-разрядной глубиной. Дополнительные сведения см. в документации Майкрософт по разработке для Unity.

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

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

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

Завершив настройку проекта Unity, узнайте, как работать с приложением на устройстве.