Aggiornamento da HoloToolkit - MRTK2

  • Articolo

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

Controller e input manuale

Installazione e configurazione

Metodi HTK 2017 MRTK v2
Type Eventi specifici per i pulsanti, con informazioni sul tipo di input quando pertinenti. Input basato su azione/movimento, passato tramite eventi.
Attrezzaggio Posizionare InputManager nella scena. Abilitare il sistema di input nel profilo di configurazione e specificare un tipo di sistema di input concreto.
Impostazione 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 mapping controller Realtà mista
  • Profilo di visualizzazione del controller Realtà mista
  • Profilo movimenti Realtà mista
  • profilo azioni di input Realtà mista
  • profilo delle regole di azione di input Realtà mista
  • Profilo puntatore Realtà mista

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

I componenti di supporto della piattaforma (ad esempio, Windows Realtà mista Gestione dispositivi) devono essere aggiunti ai provider di dati del servizio corrispondenti.

Mapping di interfacce ed eventi

Alcuni eventi non hanno più eventi univoci e ora contengono 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 alla levetta
IControllerTouchpadHandler IMixedRealityInputHandler Mappato al touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mappato al blocco nel profilo movimenti
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mappato ai pulsanti o al tocco della mano del controller
IManipulationHandler IMixedRealityGestureHandler<Vector3> Mappato alla manipolazione nel profilo movimenti
INavigationHandler IMixedRealityGestureHandler<Vector3> Mappato allo spostamento nel profilo movimenti
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Mappato alla posizione del trigger
ISourcePositionHandler IMixedRealityInputHandler<Vector3> oppure IMixedRealityInputHandler<MixedRealityPose> Mappato alla posizione o alla posizione del grip del puntatore
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> oppure IMixedRealityInputHandler<MixedRealityPose> Mappato alla posizione o alla posizione del grip del puntatore
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler e IMixedRealityInputHandler<Vector2> Mappato ai vari pulsanti e levette del controller

Fotocamera

Metodi HTK 2017 MRTK v2
Attrezzaggio Elimina MainCamera, aggiungi il prefab MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera alla scena o usa Realtà mista Toolkit > Configure > Apply Realtà mista Scene Settings (Configura applica impostazioni scena Realtà mista). MainCamera padre in MixedRealityPlayspace tramite Realtà mista Toolkit > Aggiungi alla scena e configura...
Impostazione Configurazione delle impostazioni della fotocamera eseguita nell'istanza di prefab. Impostazioni della fotocamera configurate nel profilo della fotocamera Realtà mista.

Comandi vocali

Riconoscimento della parola chiave

Metodi HTK 2017 MRTK v2
Attrezzaggio Aggiungere speechInputSource alla scena. Il servizio parole chiave (ad esempio, Gestione input vocale Windows) deve essere aggiunto ai provider di dati del sistema di input.
Impostazione Le parole chiave riconosciute vengono configurate nel controllo speechInputSource. Le parole chiave vengono configurate nel profilo dei comandi vocali Realtà mista.
Gestori eventi ISpeechHandler IMixedRealitySpeechHandler

Dettatura

Metodi HTK 2017 MRTK v2
Attrezzaggio Aggiungere un oggetto DictationInputManager alla scena. Il supporto della 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
Attrezzaggio Aggiungere il prefab SpatialMapping alla scena. Abilitare il sistema di consapevolezza spaziale nel profilo di configurazione e aggiungere un osservatore spaziale (ad esempio, Windows Realtà mista Spatial Mesh Observer) ai provider di dati di Spatial Awareness System.
Impostazione Configurare l'istanza della scena nel controllo. Configurare le impostazioni nel profilo di ogni osservatore spaziale.

Planes

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

Comprensione spaziale

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

Limite

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

Condivisione

Metodi HTK 2017 MRTK v2
Attrezzaggio Servizio di condivisione: aggiungere prefab di condivisione alla scena. UNet: usare l'esempio SharingWithUNET. Valore corrente
Impostazione Configurare le istanze della scena nel controllo. Valore corrente

Esperienza utente

Metodi HTK 2017 MRTK v2
Pulsante Oggetti interagibili Button
Interazionebile Oggetti interagibili Interazionebile
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 Tooltip Tooltip
Insieme Object Insieme Object Insieme Object
Risolutore Risolutore Risolutore

Utilità

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

HTK 2017 MRTK v2
Cartellone Billboard
Tagalong RadialView o Orbital Risolutore
FixedAngularSize ConstantViewSizeRisolutore
FpsDisplay Sistema di diagnostica (nel profilo di configurazione)
NearFade Shader standard per Realtà mista Toolkit