Обновление HoloToolkit — MRTK2

Руководство по переходу с HoloLens Toolkit (HTK) на Смешанная реальность Toolkit (MRTK).

Ввод данных с помощью контроллера и рук

Установка и настройка

Методы HTK 2017 MRTK версии 2
Тип Конкретные события для кнопок с информацией о типе входных данных, если это необходимо. Входные данные на основе действий или жестов, передаваемые через события.
Настройка Поместите InputManager в сцену. Включите систему ввода в профиле конфигурации и укажите конкретный тип системы ввода.
Конфигурация Настраивается в инспекторе для каждого отдельного скрипта в сцене. Настраивается с помощью Смешанная реальность системного профиля ввода и связанного с ним профиля, перечисленных ниже.

Связанные профили:

  • Профиль сопоставления контроллера Смешанная реальность
  • Профиль визуализации контроллера Смешанная реальность
  • Профиль жестов Смешанная реальность
  • Профиль входных действий Смешанная реальность
  • Профиль правил действий ввода Смешанная реальность
  • Профиль указателя Смешанная реальность

Параметры поставщика взгляда изменяются в объекте Основной камеры в сцене.

Компоненты поддержки платформы (например, Windows Mixed Reality диспетчер устройств) необходимо добавить в соответствующие поставщики данных службы.

Сопоставления интерфейсов и событий

Некоторые события больше не имеют уникальных событий и теперь содержат MixedRealityInputAction. Эти действия указываются в профиле действия ввода и сопоставляются с конкретными контроллерами и платформами в профиле сопоставления контроллеров. OnInputDown Такие события теперь должны проверка тип MixedRealityInputAction.

Связанные системы ввода:

HTK 2017 MRTK версии 2 Сопоставление действий
IControllerInputHandler IMixedRealityInputHandler<Vector2> Сопоставлено с сенсорной панелью или стиком
IControllerTouchpadHandler IMixedRealityInputHandler Сопоставление с сенсорной панелью
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Сопоставлено с удержанием в профиле жестов
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Сопоставлено с кнопками контроллера или касанием рукой
IManipulationHandler IMixedRealityGestureHandler<Vector3> Сопоставление с манипуляцией в профиле жестов
INavigationHandler IMixedRealityGestureHandler<Vector3> Сопоставлено с навигацией в профиле жестов
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Сопоставлено с положением триггера
ISourcePositionHandler IMixedRealityInputHandler<Vector3> или IMixedRealityInputHandler<MixedRealityPose> Сопоставляются с положением указателя или положением захвата
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> или IMixedRealityInputHandler<MixedRealityPose> Сопоставляются с положением указателя или положением захвата
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler и IMixedRealityInputHandler<Vector2> Сопоставлено с различными кнопками и стиками контроллера

Камера

Методы HTK 2017 MRTK версии 2
Настройка Удалите MainCamera, добавьте заготовку MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera в сцену или используйте пункт меню "Настройка набора средств > Смешанная реальность" > Применить параметры сцены Смешанная реальность. MainCamera для параметра MixedRealityPlayspace с помощью Смешанная реальность Toolkit > Добавить в сцену и настроить...
Конфигурация Настройка параметров камеры выполняется в экземпляре prefab. Параметры камеры, настроенные в Смешанная реальность профиле камеры.

Речь

Распознавание ключевых слов

Методы HTK 2017 MRTK версии 2
Настройка Добавьте SpeechInputSource в сцену. Служба ключевых слов (например, диспетчер ввода речи Windows) должна быть добавлена в поставщики данных системы ввода.
Конфигурация Распознанные ключевые слова настраиваются в инспекторе SpeechInputSource. Ключевые слова настраиваются в профиле Смешанная реальность речевых команд.
Обработчики событий ISpeechHandler IMixedRealitySpeechHandler

Диктовка

Методы HTK 2017 MRTK версии 2
Настройка Добавьте DictationInputManager в сцену. Для поддержки диктовки требуется добавление службы (например, диспетчера ввода диктовки Windows) в поставщики данных системы ввода.
Обработчики событий IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Понимание пространственного положения и сопоставление

Сетка

Методы HTK 2017 MRTK версии 2
Настройка Добавьте в сцену заготовку SpatialMapping. Включите систему пространственной осведомленности в профиле конфигурации и добавьте пространственного наблюдателя (например, Windows Mixed Reality наблюдателя пространственной сетки) к поставщикам данных системы пространственной осведомленности.
Конфигурация Настройте экземпляр сцены в инспекторе. Настройте параметры для профиля каждого пространственного наблюдателя.

Плоскости

Методы HTK 2017 MRTK версии 2
Настройка SurfaceMeshesToPlanes Используйте скрипт. Еще не реализовано.

Распознавание пространственных данных

Методы HTK 2017 MRTK версии 2
Настройка Добавьте в сцену заготовку SpatialUnderstanding. Еще не реализовано.
Конфигурация Настройте экземпляр сцены в инспекторе. Еще не реализовано.

Граница

Методы HTK 2017 MRTK версии 2
Настройка Добавьте скрипт в BoundaryManager сцену. Включите систему границ в профиле конфигурации.
Конфигурация Настройте экземпляр сцены в инспекторе. Настройте параметры в профиле визуализации границ.

Совместное использование

Методы HTK 2017 MRTK версии 2
Настройка Служба общего доступа: добавьте в сцену префаб общего доступа. UNet: используйте пример SharingWithUNET. ведутся работы
Конфигурация Настройте экземпляры сцены в инспекторе. ведутся работы

Пользовательский интерфейс

Методы HTK 2017 MRTK версии 2
Кнопка Взаимодействуемые объекты Button
Интерактивный объект Взаимодействуемые объекты Интерактивный объект
Ограничивающий прямоугольник Ограничивающий прямоугольник Ограничивающий прямоугольник
Панель приложения Панель приложения Панель приложения
Манипуляция одной рукой (Grb и Move) HandDraggable Обработчик манипуляций
Манипуляция двумя руками (захват,перемещение/поворот/масштабирование) TwoHandManipulatable Обработчик манипуляций
Клавиатура Заготовка клавиатуры Системная клавиатура
Всплывающая подсказка Подсказка Подсказка
Коллекция объектов Коллекция объектов Коллекция объектов
Solver Solver Solver

Служебные программы

Некоторые служебные программы были согласованы как дубликаты с системой Решателя. Если какой-либо из необходимых сценариев отсутствует, сообщите о проблеме.

HTK 2017 MRTK версии 2
Рекламный щит Billboard
Тагалонг RadialView или OrbitalРешатель
FixedAngularSize ConstantViewSizeРешатель
FpsDisplay Система диагностики (в профиле конфигурации)
NearFade Встроенный шейдер для Смешанная реальность Toolkit Standard