Использование пакетов MRTK3

Microsoft MRTK3 распространяется как набор пакетов, импортируемых в Unity с помощью Mixed Reality Feature Tool для Unity и диспетчера пакетов Unity (UPM). Эти пакеты позволяют разработчикам настраивать MRTK в своих проектах.

Зависимости

Для правильной работы некоторых пакетов MRTK3 требуются дополнительные пакеты от Майкрософт и (или) Unity. Некоторые из них являются необязательными и необходимы для доступа к дополнительным функциям.

На схеме ниже показана связь между пакетами MRTK и некоторыми зависимостями Unity.

MRTK3 Package Graph

Примечание

При импорте пакетов с помощью Mixed Reality Feature Tool управление зависимостями осуществляется автоматически.

В таблице ниже описаны зависимости пакета Mixed Reality Toolkit.

Отображаемое имя Имя пакета Описание Обязательно Необязательно
Основные определения MRTK com.microsoft.mrtk.core Общие определения, служебные программы и компоненты.
  • com.unity.xr.interaction.toolkit
  • com.unity.xr.management
Специальные возможности MRTK com.microsoft.mrtk.accessibility Определения, функции и подсистемы для создания доступных взаимодействий смешанной реальности.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.textmeshpro
Звуковые эффекты MRTK com.microsoft.mrtk.audio Эффекты и функции, которые улучшают звук во взаимодействиях смешанной реальности.
  • com.microsoft.mrtk.core
Привязка данных и темы MRTK com.microsoft.mrtk.data Поддержка привязки данных и тематического оформления элементов пользовательского интерфейса.
  • com.microsoft.mrtk.core
  • com.unity.nuget.newtonsoft-json
  • com.unity.textmeshpro
Диагностика MRTK com.microsoft.mrtk.diagnostics Подсистемы и средства диагностики и мониторинга производительности.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
Среда MRTK com.microsoft.mrtk.environment Функции и подсистемы для работы со средой, такие как отслеживание пространственного положения и границы.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
Расширенные ресурсы MRTK com.microsoft.mrtk.extendedassets Дополнительные звуки, шрифты, текстуры и другие ресурсы для использования в приложениях.
  • com.microsoft.mrtk.standardassets
  • com.microsoft.mrtk.graphicstools.unity
Инструменты для графики MRTK com.microsoft.mrtk.graphicstools.unity Шейдеры, текстуры, материалы и модели.
  • com.unity.render-pipelines.universal
Ввод данных в MRTK com.microsoft.mrtk.input Компоненты ввода, включая поддержку движений руками, автономное распознавание речи и моделирование ввода в редакторе.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.xr.interaction.toolkit
  • com.unity.inputsystem
  • com.unity.xr.management
  • com.unity.xr.openxr
  • com.unity.xr.arfoundation
Пространственные манипуляции MRTK com.microsoft.mrtk.spatialmanipulation Компоненты и служебные программы пространственного позиционирования и манипуляций, включая решатели.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.uxcore
  • com.unity.inputsystem
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.input
Стандартные ресурсы MRTK com.microsoft.mrtk.standardassets Стандартные ресурсы (включая материалы и текстуры) для использования приложениями.
  • com.microsoft.mrtk.graphicstools.unity
MRTK Tools com.microsoft.mrtk.tools Коллекция средств Unity Editor, используемых для расширения и оптимизации приложений MRTK3.
  • com.microsoft.mrtk.core
Компоненты пользовательского интерфейса MRTK com.microsoft.mrtk.uxcomponents Библиотека компонентов пользовательского интерфейса MRTK, содержащая заготовки, визуальные элементы, готовые элементы управления и все необходимое для создания трехмерных пользовательских интерфейсов для смешанной реальности.
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
Компоненты интерфейса MRTK (без холста) com.microsoft.mrtk.uxcomponents.noncanvas Библиотека компонентов UX MRTK без холста для создания трехмерного пользовательского интерфейса без макета Canvas. Для большинства пользовательских интерфейсов производственного уровня мы рекомендуем динамические гибридные системы взаимодействия на основе Canvas, расположенные в com.microsoft.mrtk.uxcomponents. Однако в некоторых случаях статический или не canvas пользовательский интерфейс может обеспечить повышенную производительность и пакетную обработку, что может быть желательно в сценариях с ограниченными ресурсами.
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
Базовый пользовательский интерфейс MRTK com.microsoft.mrtk.uxcore Основные скрипты взаимодействия и визуализации для создания компонентов пользовательского интерфейса MR.\n\nПримечание: эти компоненты применяются для создания библиотек пользовательского интерфейса. Для создания интерфейсов MR с готовой библиотекой компонентов используются ресурсы com.microsoft.mrtk.uxcomponents.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.inputsystem
  • com.unity.textmeshpro
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.data
MRTK — распознавание речи в Windows com.microsoft.mrtk.windowsspeech Реализация подсистемы распознавания речи для собственных API распознавания речи Windows. Позволяет использовать собственные средства распознавания речи Windows для запуска событий и организации взаимодействия XRI.
  • com.microsoft.mrtk.core

Выполнение тестов пакетов

Некоторые пакеты MRTK содержат тесты, используемые для проверки включенных компонентов. Иногда для этих тестов требуются дополнительные пакеты MRTK, которые не утверждаются как зависимости.

Примечание

При импорте пакетов в Unity тестовые сборки по умолчанию не компилируются. Чтобы включить компиляцию тестов, используйте элемент testables файла manifest.json проекта.

Чтобы минимизировать нагрузку на приложения, импортирующие Mixed Reality Toolkit, зависимости утверждаются только для требований среды выполнения. В таблице ниже описаны дополнительные пакеты, необходимые для компиляции и запуска включенных тестовых сборок.

Отображаемое имя Имя пакета Требования к тестам
Основные определения MRTK com.microsoft.mrtk.core
Специальные возможности MRTK com.microsoft.mrtk.accessibility
Привязка данных и темы MRTK com.microsoft.mrtk.data
Диагностика MRTK com.microsoft.mrtk.diagnostics
Среда MRTK com.microsoft.mrtk.environment
Расширенные ресурсы MRTK com.microsoft.mrtk.extendedassets
Ввод данных в MRTK com.microsoft.mrtk.input
Пространственные манипуляции MRTK com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.mrtk.input
Стандартные ресурсы MRTK com.microsoft.mrtk.standardassets
Компоненты пользовательского интерфейса MRTK com.microsoft.mrtk.uxcomponents
  • com.microsoft.mrtk.input
Базовый пользовательский интерфейс MRTK com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.input
MRTK — распознавание речи в Windows com.microsoft.mrtk.windowsspeech