Aggiornamento da HoloToolkit - MRTK2

  • Articolo

Guida alla migrazione da HoloLens Toolkit (HTK) a Realtà mista Toolkit (MRTK).

Input controller e mano

Installazione e configurazione

Metodi HTK 2017 MRTK v2
Tipo Eventi specifici per i pulsanti, con informazioni sul tipo di input quando pertinenti. Input basato su azioni/movimenti passati tramite eventi.
Installazione Posizionare InputManager nella scena. Abilitare il sistema di input nel profilo di configurazione e specificare un tipo di sistema di input concreto.
Configurazione Configurato nel controllo in ogni singolo script della scena. Configurato tramite il profilo di sistema di input Realtà mista e il relativo profilo correlato, elencati di seguito.

Profili correlati:

  • Profilo di mapping del controller Realtà mista
  • Profilo di visualizzazione del controller Realtà mista
  • Realtà mista Profilo movimenti
  • Realtà mista profilo azioni di input
  • Realtà mista profilo regole di azione di input
  • Realtà mista profilo puntatore

Le impostazioni del provider di sguardo vengono modificate nell'oggetto Fotocamera principale nella scena.

I componenti di supporto della piattaforma (ad esempio, Windows Mixed Reality Gestione dispositivi) devono essere aggiunti ai provider di dati del servizio corrispondente.

Mapping di interfacce ed eventi

Alcuni eventi non hanno più eventi univoci e ora contengono un oggetto MixedRealityInputAction. Queste azioni vengono specificate nel profilo Azioni di input e mappate a controller e piattaforme specifiche nel profilo Mapping controller. Gli eventi come OnInputDown dovrebbero ora controllare il tipo MixedRealityInputAction.

Sistemi di input correlati:

HTK 2017 MRTK v2 Mapping delle azioni
IControllerInputHandler IMixedRealityInputHandler<Vector2> Mappato al touchpad o al pollice
IControllerTouchpadHandler IMixedRealityInputHandler Mappato al touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mappato al blocco nel profilo movimenti
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mappato ai pulsanti del controller o al tocco a mano
IManipulationHandler IMixedRealityGestureHandler<Vector3> Mappato alla manipolazione nel profilo movimenti
INavigationHandler IMixedRealityGestureHandler<Vector3> Mappato alla navigazione nel profilo movimenti
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Mappato alla posizione del trigger
ISourcePositionHandler IMixedRealityInputHandler<Vector3> o IMixedRealityInputHandler<MixedRealityPose> Mappato alla posizione del puntatore o alla posizione di presa
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> o IMixedRealityInputHandler<MixedRealityPose> Mappato alla posizione del puntatore o alla posizione di presa
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler e IMixedRealityInputHandler<Vector2> Mappato ai vari pulsanti del controller e le levette

Fotocamera

Metodi HTK 2017 MRTK v2
Installazione Eliminare MainCamera, aggiungere MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera prefab alla scena o usare Realtà mista Toolkit > Configure Apply Realtà mista Scene Settings (Configurazione impostazioni > scena Realtà mista). MainCamera padreed in MixedRealityPlayspace tramite Realtà mista Toolkit > Aggiungi alla scena e Configura...
Configurazione Configurazione delle impostazioni della fotocamera eseguita nell'istanza prefab. Impostazioni della fotocamera configurate nel profilo della fotocamera di Realtà mista.

Voce

Riconoscimento della parola chiave

Metodi HTK 2017 MRTK v2
Installazione Aggiungere speechInputSource alla scena. Il servizio parola chiave (ad esempio, Windows Speech Input Manager) deve essere aggiunto ai provider di dati del sistema di input.
Configurazione Le parole chiave riconosciute sono configurate nel controllo SpeechInputSource. Le parole chiave sono configurate nel profilo comandi voce Realtà mista.
Gestori eventi ISpeechHandler IMixedRealitySpeechHandler

Dettatura

Metodi HTK 2017 MRTK v2
Installazione Aggiungere una DictationInputManager alla scena. Il supporto di dettatura richiede l'aggiunta del servizio (ad esempio, Windows Dictation Input Manager) ai provider di dati del sistema di input.
Gestori eventi IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Consapevolezza spaziale/mapping

Mesh

Metodi HTK 2017 MRTK v2
Installazione Aggiungere il prefab SpatialMapping alla scena. Abilitare il sistema di consapevolezza spaziale nel profilo di configurazione e aggiungere un osservatore spaziale (ad esempio, Windows Mixed Reality Spatial Mesh Observer) ai provider di dati del sistema di consapevolezza spaziale.
Configurazione Configurare l'istanza della scena nel controllo. Configurare le impostazioni per ogni profilo dell'osservatore spaziale.

Aerei

Metodi HTK 2017 MRTK v2
Installazione Usare lo SurfaceMeshesToPlanes script. Non ancora implementato.

Comprensione spaziale

Metodi HTK 2017 MRTK v2
Installazione Aggiungere il prefab SpatialUnderstanding alla scena. Non ancora implementato.
Configurazione Configurare l'istanza della scena nel controllo. Non ancora implementato.

Limite

Metodi HTK 2017 MRTK v2
Installazione Aggiungere lo BoundaryManager script alla scena. Abilitare il sistema di limiti nel profilo di configurazione.
Configurazione Configurare l'istanza della scena nel controllo. Configurare le impostazioni nel profilo Visualizzazione limiti.

Condivisione

Metodi HTK 2017 MRTK v2
Installazione Servizio di condivisione: aggiungere prefab di condivisione alla scena. UNet: usare l'esempio SharingWithUNET. In corso
Configurazione Configurare le istanze della scena nel controllo. In corso

Esperienza utente

Metodi HTK 2017 MRTK v2
Pulsante Oggetti interagendo Button
Interagendo Oggetti interagendo Interagendo
Riquadro Riquadro Riquadro
Barra dell'app Barra dell'app Barra dell'app
Manipolazione di una mano (grb e spostamento) HandDraggable Gestore manipolazione
Manipolazione a due mani (Afferra/Sposta/Ruota/Scala) TwoHandManipulatable Gestore manipolazione
Tastiera Prefab della tastiera Tastiera di sistema
Descrizione comando Descrizione comando Descrizione comando
Insieme Object Insieme Object Insieme Object
Solver Solver Solver

Utilità

Alcune utilità sono state riconciliate come duplicati con il sistema risolutore. Segnalare un problema se uno degli script necessari non è presente.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView o OrbitalRisolutore
FixedAngularSize ConstantViewSizeSolver
FpsDisplay Sistema di diagnostica (nel profilo di configurazione)
NearFade Shader standard di Realtà mista Toolkit