Upgraden van HoloToolkit — MRTK2

Een handleiding voor hulp bij de migratie van HoloLens Toolkit (HTK) naar Mixed Reality Toolkit (MRTK).

Controller en handinvoer

Installatie en configuratie

Methoden HTK 2017 MRTK v2
Type Specifieke gebeurtenissen voor knoppen, met invoertypegegevens indien relevant. Invoer op basis van actie/beweging, doorgegeven via gebeurtenissen.
Configuratie Plaats de InputManager in de scène. Schakel het invoersysteem in het configuratieprofiel in en geef een concreet invoersysteemtype op.
Configuratie Geconfigureerd in inspector voor elk afzonderlijk script in de scène. Geconfigureerd via het Mixed Reality Invoersysteemprofiel en het bijbehorende profiel, hieronder vermeld.

Gerelateerde profielen:

  • Toewijzingsprofiel voor Mixed Reality-controller
  • Visualisatieprofiel Mixed Reality controller
  • Mixed Reality-profiel voor bewegingen
  • Profiel voor invoeracties Mixed Reality
  • Profiel voor invoeractieregels Mixed Reality
  • Mixed Reality-aanwijzerprofiel

Instellingen van gazeprovider worden gewijzigd op het object Hoofdcamera in de scène.

Platformondersteuningsonderdelen (bijvoorbeeld Windows Mixed Reality Apparaatbeheer) moeten worden toegevoegd aan de bijbehorende gegevensproviders van de service.

Interface- en gebeurtenistoewijzingen

Sommige gebeurtenissen hebben geen unieke gebeurtenissen meer en bevatten nu een MixedRealityInputAction. Deze acties worden opgegeven in het profiel Invoeracties en toegewezen aan specifieke controllers en platforms in het profiel Controllertoewijzing. Gebeurtenissen zoals OnInputDown moeten nu het type MixedRealityInputAction controleren.

Gerelateerde invoersystemen:

HTK 2017 MRTK v2 Actietoewijzing
IControllerInputHandler IMixedRealityInputHandler<Vector2> Toegewezen aan de touchpad of duimstick
IControllerTouchpadHandler IMixedRealityInputHandler Toegewezen aan het touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Toegewezen om vast te houden in het bewegingenprofiel
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Toegewezen aan de knoppen van de controller of tikken met de hand
IManipulationHandler IMixedRealityGestureHandler<Vector3> Toegewezen aan manipulatie in het bewegingenprofiel
INavigationHandler IMixedRealityGestureHandler<Vector3> Toegewezen aan navigatie in het bewegingenprofiel
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Toegewezen aan triggerpositie
ISourcePositionHandler IMixedRealityInputHandler<Vector3> of IMixedRealityInputHandler<MixedRealityPose> Toegewezen aan de aanwijzerpositie of grippositie
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> of IMixedRealityInputHandler<MixedRealityPose> Toegewezen aan de aanwijzerpositie of grippositie
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler en IMixedRealityInputHandler<Vector2> Toegewezen aan de verschillende controllerknoppen en duimsticks

Camera

Methoden HTK 2017 MRTK v2
Configuratie Verwijder MainCamera, voeg MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera-prefab toe aan scène of gebruik Mixed Reality Toolkit > Mixed Reality > menu-item Scène-instellingen toepassen configureren. MainCamera bovenliggend onder MixedRealityPlayspace via Mixed Reality Toolkit > Toevoegen aan scène en configureren...
Configuratie Configuratie van camera-instellingen uitgevoerd op prefab-exemplaar. Camera-instellingen die zijn geconfigureerd in het Mixed Reality Cameraprofiel.

Toespraak

Trefwoordherkenning

Methoden HTK 2017 MRTK v2
Configuratie Voeg een SpeechInputSource toe aan uw scène. Trefwoordservice (bijvoorbeeld Windows Speech Input Manager) moet worden toegevoegd aan de gegevensproviders van het invoersysteem.
Configuratie Herkende trefwoorden worden geconfigureerd in de inspector van SpeechInputSource. Trefwoorden worden geconfigureerd in het profiel Mixed Reality Spraakopdrachten.
Gebeurtenishandlers ISpeechHandler IMixedRealitySpeechHandler

Dicteren

Methoden HTK 2017 MRTK v2
Configuratie Voeg een DictationInputManager toe aan uw scène. Voor ondersteuning van dicteren moet service (bijvoorbeeld Windows Dictation Input Manager) worden toegevoegd aan de gegevensproviders van het invoersysteem.
Gebeurtenishandlers IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Ruimtelijk bewustzijn/ in kaart brengen

Mesh

Methoden HTK 2017 MRTK v2
Configuratie Voeg de prefab SpatialMapping toe aan de scène. Schakel het Spatial Awareness System in het configuratieprofiel in en voeg een ruimtelijke waarnemer (bijvoorbeeld Windows Mixed Reality Spatial Mesh Observer) toe aan de gegevensproviders van het Spatial Awareness System.
Configuratie Configureer het scène-exemplaar in de inspector. Configureer de instellingen voor het profiel van elke ruimtelijke waarnemer.

Vliegtuigen

Methoden HTK 2017 MRTK v2
Configuratie Gebruik het SurfaceMeshesToPlanes script. Nog niet geïmplementeerd.

Ruimtelijk inzicht

Methoden HTK 2017 MRTK v2
Configuratie Voeg de prefab SpatialUnderstanding toe aan de scène. Nog niet geïmplementeerd.
Configuratie Configureer het scène-exemplaar in de inspector. Nog niet geïmplementeerd.

Grens

Methoden HTK 2017 MRTK v2
Configuratie Voeg het BoundaryManager script toe aan de scène. Schakel het grenssysteem in het configuratieprofiel in.
Configuratie Configureer het scène-exemplaar in de inspector. Configureer de instellingen in het profiel Grensvisualisatie.

Delen

Methoden HTK 2017 MRTK v2
Configuratie Service voor delen: Voeg prefab voor delen toe aan de scène. UNet: Voorbeeld van SharingWithUNET gebruiken. Wordt uitgevoerd
Configuratie Configureer de scène-exemplaren in de inspector. Wordt uitgevoerd

UX

Methoden HTK 2017 MRTK v2
Knop Interactiebare objecten Knop
Interactiebaar Interactiebare objecten Interactiebaar
Selectiekader Selectiekader Selectiekader
App-balk App-balk App-balk
Manipulatie met één hand (Grb en Move) HandDraggable Manipulatiehandler
Tweehandsmanipulatie (grijpen/verplaatsen/draaien/schalen) TwoHandManipulatable Manipulatiehandler
Toetsenbord Toetsenbord prefab Systeemtoetsenbord
Tooltip Tooltip Tooltip
Objectverzameling Objectverzameling Objectverzameling
Oplosser Oplosser Oplosser

Utilities

Sommige hulpprogramma's zijn als duplicaten afgestemd op het oplossersysteem. Dien een probleem in als een van de benodigde scripts ontbreekt.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView of OrbitalOplosser
FixedAngularSize ConstantViewSize Oplosser
FpsDisplay Diagnostisch systeem (in configuratieprofiel)
NearFade Ingebouwd in Mixed Reality Toolkit Standard-shader