Udostępnij za pośrednictwem

Uaktualnianie z urządzenia HoloToolkit — MRTK2

  • Artykuł

Przewodnik ułatwiający migrację z zestawu narzędzi HoloLens Toolkit (HTK) do zestawu narzędzi Mixed Reality Toolkit (MRTK).

Wejście kontrolera i ręki

Instalacja i konfiguracja

Metody HTK 2017 MRTK v2
Typ Określone zdarzenia dla przycisków z informacjami o typie wejściowym, gdy są istotne. Dane wejściowe oparte na akcjach/gestach przekazywane za pośrednictwem zdarzeń.
Konfigurowanie Umieść element InputManager w scenie. Włącz system wejściowy w profilu konfiguracji i określ konkretny typ systemu wejściowego.
Konfigurowanie Skonfigurowany w inspektorze na każdym skrypcie w scenie. Skonfigurowane za pośrednictwem Mixed Reality profilu systemu wejściowego i powiązanego z nią profilu, wymienionego poniżej.

Powiązane profile:

  • Profil mapowania kontrolera Mixed Reality
  • Profil wizualizacji kontrolera Mixed Reality
  • Profil gestów Mixed Reality
  • profil akcji wejściowych Mixed Reality
  • profil reguł akcji wejściowych Mixed Reality
  • profil wskaźnika Mixed Reality

Ustawienia dostawcy spojrzenia są modyfikowane w obiekcie Main Camera w scenie.

Składniki obsługi platformy (np. Windows Mixed Reality Menedżer urządzeń) muszą zostać dodane do odpowiednich dostawców danych usługi.

Interfejs i mapowania zdarzeń

Niektóre zdarzenia nie mają już unikatowych zdarzeń i zawierają teraz MixedRealityInputAction. Te akcje są określane w profilu Akcje wejściowe i mapowane na określone kontrolery i platformy w profilu mapowania kontrolera. Zdarzenia takie jak OnInputDown powinny teraz sprawdzać typ MixedRealityInputAction.

Powiązane systemy wejściowe:

HTK 2017 MRTK v2 Mapowanie akcji
IControllerInputHandler IMixedRealityInputHandler<Vector2> Mapowane na touchpad lub kciuk
IControllerTouchpadHandler IMixedRealityInputHandler Mapowane na tablet dotykowy
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Zamapowane na blokadę w profilu gestów
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Zamapowane na przyciski kontrolera lub naciśnięcie ręczne
IManipulationHandler IMixedRealityGestureHandler<Vector3> Zamapowane na manipulowanie profilem gestów
INavigationHandler IMixedRealityGestureHandler<Vector3> Mapowane na nawigację w profilu gestów
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Zamapowane na pozycję wyzwalacza
ISourcePositionHandler IMixedRealityInputHandler<Vector3> lub IMixedRealityInputHandler<MixedRealityPose> Mapowane na położenie wskaźnika lub położenie uchwytu
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> lub IMixedRealityInputHandler<MixedRealityPose> Mapowane na położenie wskaźnika lub położenie uchwytu
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler i IMixedRealityInputHandler<Vector2> Zamapowane na różne przyciski kontrolera i szminki

Aparat fotograficzny

Metody HTK 2017 MRTK v2
Konfigurowanie Usuń maincamera, dodaj MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab do sceny lub użyj Mixed Reality Toolkit > Configure Apply Mixed Reality Scene Settings (Skonfiguruj > ustawienia zastosuj Mixed Reality sceny). MainCamera nadrzędne w obszarze MixedRealityPlayspace za pośrednictwem zestawu narzędzi Mixed Reality Dodaj > do sceny i Konfiguruj...
Konfiguracja Konfiguracja ustawień aparatu wykonywana na wystąpieniu prefab. Ustawienia aparatu skonfigurowane w profilu aparatu Mixed Reality.

Mowa

Rozpoznawanie słów kluczowych

Metody HTK 2017 MRTK v2
Konfigurowanie Dodaj element SpeechInputSource do sceny. Usługa słowa kluczowego (np. Menedżer wprowadzania mowy systemu Windows) musi zostać dodana do dostawców danych systemu wejściowego.
Konfiguracja Rozpoznane słowa kluczowe są konfigurowane w inspektorze usługi SpeechInputSource. Słowa kluczowe są konfigurowane w profilu poleceń mowy Mixed Reality.
Procedury obsługi zdarzeń ISpeechHandler IMixedRealitySpeechHandler

Dyktowania

Metody HTK 2017 MRTK v2
Konfigurowanie Dodaj element DictationInputManager do sceny. Obsługa dyktowania wymaga dodania usługi (np. Menedżera dyktowania systemu Windows) do dostawców danych systemu wprowadzania danych.
Procedury obsługi zdarzeń IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Świadomość przestrzenna/mapowanie

Siatka

Metody HTK 2017 MRTK v2
Konfigurowanie Dodaj prefab spatialMapping do sceny. Włącz system rozpoznawania przestrzennego w profilu konfiguracji i dodaj obserwatora przestrzennego (np. obserwatora usługi Windows Mixed Reality Spatial Mesh) do dostawców danych systemu rozpoznawania przestrzennego.
Konfiguracja Skonfiguruj wystąpienie sceny w inspektorze. Skonfiguruj ustawienia w profilu każdego obserwatora przestrzennego.

Samoloty

Metody HTK 2017 MRTK v2
Konfigurowanie Użyj skryptu SurfaceMeshesToPlanes . Jeszcze nie zaimplementowano.

Interpretacja przestrzenna

Metody HTK 2017 MRTK v2
Konfigurowanie Dodaj prefab spatialUnderstanding prefab do sceny. Jeszcze nie zaimplementowano.
Konfiguracja Skonfiguruj wystąpienie sceny w inspektorze. Jeszcze nie zaimplementowano.

Granicy

Metody HTK 2017 MRTK v2
Konfigurowanie BoundaryManager Dodaj skrypt do sceny. Włącz system granic w profilu konfiguracji.
Konfigurowanie Skonfiguruj wystąpienie sceny w inspektorze. Skonfiguruj ustawienia w profilu Wizualizacja granic.

Udostępnianie

Metody HTK 2017 MRTK v2
Konfigurowanie Usługa udostępniania: dodaj prefab udostępnianie do sceny. UNet: użyj przykładu SharingWithUNET. W toku
Konfiguracja Skonfiguruj wystąpienia sceny w inspektorze. W toku

Środowisko użytkownika (UX)

Metody HTK 2017 MRTK v2
Przycisk Obiekty z możliwością interakcji Przycisk
Możliwość interakcji Obiekty z możliwością interakcji Możliwość interakcji
Obwiedni Obwiedni Obwiedni
Pasek aplikacji Pasek aplikacji Pasek aplikacji
Manipulowanie ręką (Grb i przenoszenie) HandDraggable Procedura obsługi manipulowania
Manipulowanie dwiema rękami (chwyt, przenoszenie/obracanie/skalowanie) TwoHandManipulatable Procedura obsługi manipulowania
Klawiatura Prefab klawiatury Klawiatura systemowa
Etykietka narzędzia Etykietka narzędzia Etykietka narzędzia
Kolekcja obiektów Kolekcja obiektów Kolekcja obiektów
Moduł rozwiązywania Moduł rozwiązywania Moduł rozwiązywania

Narzędzia

Niektóre narzędzia zostały uzgodnione jako duplikaty z systemem modułu rozwiązywania. Zgłoś problem, jeśli brakuje dowolnego z potrzebnych skryptów.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView lub Orbitalmoduł rozwiązywania
FixedAngularSize ConstantViewSizeSolver
FpsDisplay System diagnostyczny (w profilu konfiguracji)
NearFade Wbudowany moduł cieniowania zestawu narzędzi Mixed Reality Toolkit w warstwie Standardowa