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
Typ	Bestimmte Ereignisse für Schaltflächen mit Eingabetypinformationen, falls relevant.	Aktions-/Gestenbasierte Eingabe, die über Ereignisse übergeben wird.
Einrichten	Platzieren Sie den InputManager in der Szene.	Aktivieren Sie das Eingabesystem im Konfigurationsprofil , und geben Sie einen konkreten Eingabesystemtyp an.
Konfiguration	Konfiguriert im Inspector für jedes einzelne Skript in der Szene.	Konfiguriert über das Mixed Reality Eingabesystemprofil und das zugehörige Profil, das unten aufgeführt ist.

Verwandte Profile:

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

Die Einstellungen des Anzeigeanbieters werden für das Hauptkameraobjekt in der Szene geändert.

Plattformunterstützungskomponenten (z. B. Windows Mixed Reality Geräte-Manager) müssen den Datenanbietern des entsprechenden 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 Profil Eingabeaktionen angegeben und bestimmten Controllern und Plattformen im Profil Controllerzuordnung zugeordnet. Ereignisse wie OnInputDown sollten nun den MixedRealityInputAction-Typ überprüfen.

Verwandte Eingabesysteme:

• Übersicht über die Eingabe
• Eingabeereignisse
• Eingabezeiger

HTK 2017	MRTK v2	Aktionszuordnung
IControllerInputHandler	IMixedRealityInputHandler<Vector2>	Dem Touchpad oder Fingerabdruckstick zugeordnet
IControllerTouchpadHandler	IMixedRealityInputHandler	Dem Touchpad zugeordnet
IFocusable	IMixedRealityFocusHandler
IGamePadHandler	IMixedRealitySourceStateHandler
IHoldHandler	IMixedRealityGestureHandler	Dem Halten im Gestenprofil zugeordnet
IInputClickHandler	IMixedRealityPointerHandler
IInputHandler	IMixedRealityInputHandler	Zugeordnet den Schaltflächen des Controllers oder Hand tippen
IManipulationHandler	IMixedRealityGestureHandler<Vector3>	Zuordnung zur Bearbeitung im Gestenprofil
INavigationHandler	IMixedRealityGestureHandler<Vector3>	Der Navigation im Gestenprofil zugeordnet
IPointerSpecificFocusable	IMixedRealityFocusChangedHandler
ISelectHandler	IMixedRealityInputHandler<float>	Der Triggerposition zugeordnet
ISourcePositionHandler	IMixedRealityInputHandler<Vector3> oder IMixedRealityInputHandler<MixedRealityPose>	Zuordnung zur Zeigerposition oder Griffposition
ISourceRotationHandler	IMixedRealityInputHandler<Quaternion> oder IMixedRealityInputHandler<MixedRealityPose>	Zuordnung zur Zeigerposition oder Griffposition
ISourceStateHandler	IMixedRealitySourceStateHandler
IXboxControllerHandler	IMixedRealityInputHandler und IMixedRealityInputHandler<Vector2>	Zugeordnet den verschiedenen Controllertasten und Fingersticks

Camera

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 > Konfigurieren > Anwenden Mixed Reality Szeneneinstellungen menüelement.	MainCamera wird unter MixedRealityPlayspace über Mixed Reality Toolkit > zu Szene hinzufügen und konfigurieren...
Konfiguration	Kameraeinstellungen werden auf prefab-instance ausgeführt.	Kameraeinstellungen, die im Mixed Reality Kameraprofil 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 Speech Input Manager) muss den Datenanbietern des Eingabesystems hinzugefügt werden.
Konfiguration	Erkannte Schlüsselwörter werden im SpeechInputSource-Inspektor 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.	Für die Diktierunterstützung muss der Dienst (z. B. Windows Dictation Input Manager) den Datenanbietern des Eingabesystems hinzugefügt werden.
Ereignishandler	IDictationHandler	IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Räumliches Bewusstsein/Zuordnung

Mesh

Methoden	HTK 2017	MRTK v2
Einrichten	Fügen Sie der Szene das SpatialMapping-Prefab hinzu.	Aktivieren Sie das Spatial Awareness System im Konfigurationsprofil, und fügen Sie den Datenanbietern des Spatial Awareness Systems einen räumlichen Beobachter (z. B. Windows Mixed Reality Spatial Mesh Observer) hinzu.
Konfiguration	Konfigurieren Sie die Szene instance 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 das Prefab SpatialUnderstanding hinzu.	Noch nicht implementiert.
Konfiguration	Konfigurieren Sie die Szene instance 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 Szene instance im Inspektor.	Konfigurieren Sie die Einstellungen im Profil Begrenzungsvisualisierung.

Freigabe

Methoden	HTK 2017	MRTK v2
Einrichten	Freigabedienst: Fügen Sie der Szene das Freigabe-Prefab hinzu. UNet: Verwenden Sie das SharingWithUNET-Beispiel.	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
Einhandmanipulation (Grb und Move)	HandDraggierbar	Manipulationshandler
Zwei Handmanipulation (Greifen/Bewegen/Drehen/Skalieren)	TwoHandManipulatable	Manipulationshandler
Tastatur	Tastaturvorbereitung	Systemtastatatur
QuickInfo	QuickInfo	QuickInfo
Objektsammlung	Objektauflistung	Objektauflistung
Solver	Solver	Solver

Versorgungsunternehmen

Einige Hilfsprogramme wurden als Duplikate mit dem Solver-System abgeglichen. Bitte melden Sie ein Problem, wenn eines 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