Udostępnij za pośrednictwem


Uaktualnianie z zestawu HoloToolkit — MRTK2

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

Kontroler i wejście ręczne

Instalacja i konfiguracja

Metody HTK 2017 MRTK v2
Typ Określone zdarzenia dla przycisków z informacjami o typie danych wejściowych, gdy są istotne. Dane wejściowe oparte na akcjach/gestach przekazywane za pośrednictwem zdarzeń.
Ustawienia 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. Skonfigurowano za pomocą profilu systemu Mixed Reality Input System i powiązanego z nią profilu wymienionego poniżej.

Powiązane profile:

  • Profil mapowania kontrolera rzeczywistości mieszanej
  • Profil wizualizacji kontrolera rzeczywistości mieszanej
  • Profil gestów rzeczywistości mieszanej
  • Profil akcji wejściowych rzeczywistości mieszanej
  • Profil reguł akcji akcji wprowadzania rzeczywistości mieszanej
  • Profil wskaźnika rzeczywistości mieszanej

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.

Mapowania interfejsów i zdarzeń

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

Powiązane systemy wejściowe:

HTK 2017 MRTK v2 Mapowanie akcji
IControllerInputHandler IMixedRealityInputHandler<Vector2> Zamapowane na klawiaturę dotykową lub kciuk
IControllerTouchpadHandler IMixedRealityInputHandler Zamapowane na touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mapowane na blokadę w profilu gestów
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Zamapowane na przyciski kontrolera lub naciśnięcie ręki
IManipulationHandler IMixedRealityGestureHandler<Vector3> Mapowane na manipulowanie w profilu 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

Kamera

Metody HTK 2017 MRTK v2
Ustawienia Usuń maincamera, dodaj MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab do sceny lub użyj elementu menu Zastosuj ustawienia sceny rzeczywistości > > mieszanej. MainCamera nadrzędne w obszarze MixedRealityPlayspace za pośrednictwem zestawu narzędzi Mixed Reality Toolkit > Dodaj do sceny i Konfiguruj...
Konfigurowanie Konfiguracja ustawień aparatu wykonywana na wystąpieniu prefab. Ustawienia aparatu fotograficznego skonfigurowane w profilu aparatu rzeczywistości mieszanej.

Mowa

Rozpoznawanie słów kluczowych

Metody HTK 2017 MRTK v2
Ustawienia 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.
Konfigurowanie Rozpoznane słowa kluczowe są konfigurowane w inspektorze usługi SpeechInputSource. Słowa kluczowe są konfigurowane w profilu poleceń mowy rzeczywistości mieszanej.
Procedury obsługi zdarzeń ISpeechHandler IMixedRealitySpeechHandler

Dyktowanie

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

Świadomość przestrzenna/mapowanie

Siatka

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

Samoloty

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

Interpretacja przestrzenna

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

Granica

Metody HTK 2017 MRTK v2
Ustawienia 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
Ustawienia Usługa udostępniania: dodaj prefab udostępnianie do sceny. UNet: użyj przykładu SharingWithUNET. W toku
Konfigurowanie Skonfiguruj wystąpienia sceny w inspektorze. W toku

Środowisko użytkownika (UX)

Metody HTK 2017 MRTK v2
Przycisk Obiekty umożliwiające interakcję Przycisk
Możliwość interakcji Obiekty umożliwiające interakcję Możliwość interakcji
Obwiedni Obwiedni Obwiedni
Pasek aplikacji Pasek aplikacji Pasek aplikacji
Manipulowanie jedną ręką (Grb i Move) HandDraggable Obsługa manipulacji
Manipulowanie dwiema rękami (chwytanie/przenoszenie/obracanie/skalowanie) TwoHandManipulatable Obsługa manipulacji
Klawiatura Prefab klawiatury Klawiatura systemowa
Etykietka narzędzia Tooltip Tooltip
Kolekcja obiektów Kolekcja obiektów Kolekcja obiektów
Zmienna Solver Solver

Narzędzia

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

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