Freigeben über


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:

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