Freigeben über


Upgrade von HoloToolkit – MRTK2

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

Steuerungs- und Handeingabe

Setup und Konfiguration

Methoden HTK 2017 MRTK v2
type Bestimmte Ereignisse für Schaltflächen mit Eingabetypinformationen, wenn relevant. Aktions-/Gestenbasierte Eingabe, die über Ereignisse übergeben wird.
Setup Platzieren Sie den InputManager in der Szene. Aktivieren Sie das Eingabesystem im Konfigurationsprofil , und geben Sie einen konkreten Eingabesystemtyp an.
Konfiguration Konfiguriert im Inspektor für jedes einzelne Skript in der Szene. Konfiguriert über das Mixed Reality-Eingabesystemprofil und das zugehörige Profil unten.

Verwandte Profile:

  • Mixed Reality Controller-Zuordnungsprofil
  • Mixed Reality Controller Visualisierungsprofil
  • Mixed Reality-Gestenprofil
  • Profil von Mixed Reality-Eingabeaktionen
  • Mixed Reality-Eingabeaktionsregelnprofil
  • Mixed Reality-Zeigerprofil

Gaze Provider-Einstellungen werden im Hauptkameraobjekt in der Szene geändert.

Plattformunterstützungskomponenten (z. B. Windows Mixed Reality Geräte-Manager) müssen den Entsprechenden Dienstdatenanbietern 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 OnInputDown sollten nun den MixedRealityInputAction-Typ überprüfen.

Verwandte Eingabesysteme:

HTK 2017 MRTK v2 Aktionszuordnung
IControllerInputHandler IMixedRealityInputHandler<Vector2> Dem Touchpad oder Ministick zugeordnet
IControllerTouchpadHandler IMixedRealityInputHandler Dem Touchpad zugeordnet
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Im Gestenprofil zu haltende Sperre zugeordnet
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Zugeordnet zu den Schaltflächen oder Handtippen des Controllers
IManipulationHandler IMixedRealityGestureHandler<Vector3> Zuordnung zur Manipulation im Gestenprofil
INavigationHandler IMixedRealityGestureHandler<Vector3> Zugeordnete Navigation im Gestenprofil
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Zugeordnet zur Triggerposition
ISourcePositionHandler IMixedRealityInputHandler<Vector3> oder IMixedRealityInputHandler<MixedRealityPose> Zugeordnete Zeigerposition oder Griffposition
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> oder IMixedRealityInputHandler<MixedRealityPose> Zugeordnete Zeigerposition oder Griffposition
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler und IMixedRealityInputHandler<Vector2> Zugeordnet zu den verschiedenen Controllertasten und Ministicks

Kamera

Methoden HTK 2017 MRTK v2
Setup 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 Settings-Menüelement. MainCamera unter MixedRealityPlayspace über Mixed Reality Toolkit > zu Szene hinzufügen und konfigurieren...
Konfiguration Die Konfiguration der Kameraeinstellungen, die für die Vorabinstanz ausgeführt wurde. Kameraeinstellungen, die im Mixed Reality-Kameraprofil konfiguriert sind.

Speech

Schlüsselworterkennung

Methoden HTK 2017 MRTK v2
Setup 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 Inspektor von SpeechInputSource konfiguriert. Schlüsselwörter werden im Mixed Reality-Sprachbefehlsprofil konfiguriert.
Ereignishandler ISpeechHandler IMixedRealitySpeechHandler

Diktieren

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

Räumliches Bewusstsein /Zuordnung

Mesh

Methoden HTK 2017 MRTK v2
Setup Fügen Sie der Szene das SpatialMapping-Prefab hinzu. Aktivieren Sie das Räumliche Sensibilisierungssystem im Konfigurationsprofil und fügen Sie dem Datenanbieter des Spatial Awareness Systems einen räumlichen Beobachter (z. B. Windows Mixed Reality Spatial Mesh Observer) 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
Setup Verwenden Sie das SurfaceMeshesToPlanes Skript. Nicht implementiert

Räumliches Verständnis

Methoden HTK 2017 MRTK v2
Setup Fügen Sie der Szene das SpatialUnderstanding-Prefab hinzu. Nicht implementiert
Konfiguration Konfigurieren Sie die Szeneninstanz im Inspektor. Nicht implementiert

Grenze

Methoden HTK 2017 MRTK v2
Setup Fügen Sie das BoundaryManager Skript der Szene hinzu. Aktivieren Sie das Grenzsystem im Konfigurationsprofil.
Konfiguration Konfigurieren Sie die Szeneninstanz im Inspektor. Konfigurieren Sie die Einstellungen im Grenzvisualisierungsprofil.

Freigabe

Methoden HTK 2017 MRTK v2
Setup Freigabedienst: Fügen Sie der Szene freigabe prefab hinzu. UNet: Verwenden Des SharingWithUNET-Beispiels. In Bearbeitung
Konfiguration Konfigurieren Sie die Szeneninstanzen im Inspektor. In Bearbeitung

UX

Methoden HTK 2017 MRTK v2
Taste Interagierbare Objekte Schaltfläche
Interaktionsfähig Interagierbare Objekte Interagierbar
Umgebendes Feld Begrenzungsrahmen Begrenzungsrahmen
App-Leiste App-Leiste App-Leiste
One Hand Manipulation (Grb und Move) HandDraggable Manipulationshandler
Zwei-Hand-Manipulation (Ziehen/Verschieben/Drehen/Skalieren) TwoHandManipulatable Manipulationshandler
Tastatur Tastaturvorab Systemtastatur
QuickInfo Tooltip Tooltip
Objektsammlung Object-Auflistung Object-Auflistung
Solver Solver Solver

Versorgungsunternehmen

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

HTK 2017 MRTK v2
Anschlagbrett Billboard
Tagalong RadialView oder Orbital Solver
FixedAngularSize ConstantViewSizeLöser
FpsDisplay Diagnosesystem (im Konfigurationsprofil)
NearFade Integrierter Mixed Reality Toolkit Standard-Shader