Upgrade von HoloToolkit – MRTK2

Ein Leitfaden, der Ihnen bei der Migration von HoloLens Toolkit (HTK) zu Mixed Reality Toolkit (MRTK) hilft.

Controller und Handeingabe

Setup und Konfiguration

Methoden HTK 2017 MRTK v2
type Bestimmte Ereignisse für Schaltflächen, mit Eingabetypinformationen bei Relevantem. Aktion / Gestebasierte Eingabe, übergeben über Ereignisse.
Einrichten Platzieren Sie den InputManager in der Szene. Aktivieren Sie das Eingabesystem im Konfigurationsprofil und geben Sie einen konkreten Eingabesystemtyp an.
Konfiguration Konfiguriert im Inspektor, auf jedem einzelnen Skript in der Szene. Konfiguriert über das Mixed Reality Eingabesystemprofil und sein zugehöriges Profil, das unten aufgeführt ist.

Verwandte Profile:

  • Mixed Reality Controllerzuordnungsprofil
  • Mixed Reality Controllervisualisierungsprofil
  • Mixed Reality Gestenprofil
  • Mixed Reality Profil für Eingabeaktionen
  • Mixed Reality Profil für Eingabeaktionsregeln
  • Mixed Reality Zeigerprofil

Die Einstellungen des Blickanbieters werden auf dem Main-Kamera-Objekt in der Szene geändert.

Plattformunterstützungskomponenten (z. B. Windows Mixed Reality Geräte-Manager) müssen den entsprechenden Datenanbietern des Diensts hinzugefügt werden.

Schnittstellen- und Ereigniszuordnungen

Einige Ereignisse verfügen nicht mehr über eindeutige Ereignisse und enthalten jetzt eine MixedRealityInputAction. Diese Aktionen werden im Eingabeaktionenprofil angegeben und bestimmten Controllern und Plattformen im Controllerzuordnungsprofil zugeordnet. Ereignisse wie sollten OnInputDown nun den MixedRealityInputAction-Typ überprüfen.

Verwandte Eingabesysteme:

HTK 2017 MRTK v2 Aktionszuordnung
IControllerInputHandler IMixedRealityInputHandler<Vector2> Zugeordnet dem Touchpad oder Dem Fingerstick
IControllerTouchpadHandler IMixedRealityInputHandler Zugeordnet dem Touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Zugeordnet zum Halten im Gestenprofil
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Zugeordnet zu den Schaltflächen oder Handschaltflächen des Controllers
IManipulationHandler IMixedRealityGestureHandler<Vector3> Zugeordnet der Manipulation im Gestenprofil
INavigationHandler IMixedRealityGestureHandler<Vector3> Zugeordnet der Navigation im Gestenprofil
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Zugeordnet der Triggerposition
ISourcePositionHandler IMixedRealityInputHandler<Vector3> oder IMixedRealityInputHandler<MixedRealityPose> Zugeordnet der Zeigerposition oder Griffposition
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> oder IMixedRealityInputHandler<MixedRealityPose> Zugeordnet der Zeigerposition oder Griffposition
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler und IMixedRealityInputHandler<Vector2> Zugeordnet an die verschiedenen Controllerschaltflächen und Daumensticks

Kamera

Methoden HTK 2017 MRTK v2
Einrichten Löschen Sie MainCamera, fügen Sie MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab zur Szene hinzu oder verwenden Sie Mixed Reality Toolkit > Configure > Apply Mixed Reality Scene Einstellungen Menüelement. MainCamera unter MixedRealityPlayspace über Mixed Reality Toolkit > Hinzufügen zu Szene und Konfigurieren...
Konfiguration Kamera Einstellungenkonfiguration, die in der Prefab-Instanz ausgeführt wird. Kamera Einstellungen, die im Mixed Reality Kamera Profil konfiguriert sind.

Spracheingabe/-ausgabe

Schlüsselworterkennung

Methoden HTK 2017 MRTK v2
Einrichten Fügen Sie Ihrer Szene eine SpeechInputSource hinzu. Schlüsselwortdienst (z. B. Windows Spracheingabe-Manager) muss den Datenanbietern des Eingabesystems hinzugefügt werden.
Konfiguration Erkannte Schlüsselwörter werden im Inspektor von SpeechInputSource konfiguriert. Schlüsselwörter werden im Mixed Reality Sprachbefehlsprofil konfiguriert.
Ereignishandler ISpeechHandler IMixedRealitySpeechHandler

Diktieren

Methoden HTK 2017 MRTK v2
Einrichten Fügen Sie Ihrer Szene einen DiktatInputManager hinzu. Die Diktierunterstützung erfordert den Dienst (z. B. Windows Diktateingabe-Manager), der den Datenanbietern des Eingabesystems hinzugefügt werden soll.
Ereignishandler IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Räumliches Bewusstsein / Zuordnung

Mesh

Methoden HTK 2017 MRTK v2
Einrichten Fügen Sie der Szene die SpatialMapping-Prefab hinzu. Aktivieren Sie das Räumliche Sensibilisierungssystem im Konfigurationsprofil und fügen Sie dem Datenanbieter des Räumlichen Bewusstseinssystems einen räumlichen Beobachter (z. B. Windows Mixed Reality Räumliche Mesh Beobachter) hinzu.
Konfiguration Konfigurieren Sie die Szeneninstanz im Inspektor. Konfigurieren Sie die Einstellungen für das Profil jedes räumlichen Beobachters.

Flugzeuge

Methoden HTK 2017 MRTK v2
Einrichten Verwenden Sie das SurfaceMeshesToPlanes Skript. Noch nicht implementiert.

Räumliches Verständnis

Methoden HTK 2017 MRTK v2
Einrichten Fügen Sie der Szene den SpatialUnderstanding-Prefab hinzu. Noch nicht implementiert.
Konfiguration Konfigurieren Sie die Szeneninstanz im Inspektor. Noch nicht implementiert.

Grenze

Methoden HTK 2017 MRTK v2
Einrichten Fügen Sie das BoundaryManager Skript zur Szene hinzu. Aktivieren Sie das Begrenzungssystem im Konfigurationsprofil.
Konfiguration Konfigurieren Sie die Szeneninstanz im Inspektor. Konfigurieren Sie die Einstellungen im Profil "Begrenzungsvisualisierung".

Freigabe

Methoden HTK 2017 MRTK v2
Einrichten Freigabedienst: Hinzufügen von Freigabe-Prefab zur Szene. UNet: Verwenden des Beispiels "SharingWithUNET". Wird ausgeführt
Konfiguration Konfigurieren Sie die Szeneninstanzen im Inspektor. Wird ausgeführt

UX

Methoden HTK 2017 MRTK v2
Schaltfläche Interagierbare Objekte Schaltfläche
Interaktionsfähig Interagierbare Objekte Interaktionsfähig
Umgebendes Feld Begrenzungsrahmen Begrenzungsrahmen
App-Leiste App-Leiste App-Leiste
Eine Handbearbeitung (Grb und Verschieben) HandDraggable Manipulationshandler
Zwei Handbearbeitung (Grab/Move/Drehung/Skalierung) TwoHandManipulatable Manipulationshandler
Tastatur Tastaturvorabab Systemtastatur
QuickInfo QuickInfo QuickInfo
Objektsammlung Objektsammlung Objektsammlung
Solver Solver Solver

Versorgungsunternehmen

Einige Dienstprogramme wurden als Duplikate mit dem Solver-System abgeglichen. Bitte geben Sie ein Problem an, wenn eine der benötigten Skripts fehlt.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView oder OrbitalSolver
FixedAngularSize ConstantViewSizeSolver
FpsDisplay Diagnosesystem (im Konfigurationsprofil)
NearFade Integriert in Mixed Reality Toolkit Standard-Shader