Guida alla conversione

Guida per la migrazione da HoloLens Toolkit (HTK) a Mixed Reality Toolkit (MRTK).

Controller e input manuale

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 azione/movimento, passato tramite eventi.
Eseguire la configurazione Inserire InputManager nella scena. Abilitare il sistema di input nel profilo di configurazione e specificare un tipo di sistema di input concreto.
Configurazione Configurato in Inspector, in ogni singolo script nella scena. Configurata tramite il profilo del sistema di input di realtà mista e il profilo correlato, elencati di seguito.

Profili correlati:

  • Profilo di mapping del controller di realtà mista
  • Profilo di visualizzazione del controller di realtà mista
  • Profilo movimenti di realtà mista
  • Profilo azioni input realtà mista
  • Profilo regole azione input realtà mista
  • Profilo puntatore di 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 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 mixedRealityInputAction. Queste azioni vengono specificate nel profilo Azioni di input e mappate a controller e piattaforme specifici nel profilo di Mapping controller. Gli eventi OnInputDown come ora controllano 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 per contenere nel profilo movimenti
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mappato ai pulsanti del controller o al tocco manuale
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 al punto di aderenza
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> o IMixedRealityInputHandler<MixedRealityPose> Mappato alla posizione del puntatore o al punto di aderenza
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler E IMixedRealityInputHandler<Vector2> Mappato ai vari pulsanti e puntini di identificazione personale del controller

Fotocamera

Metodi HTK 2017 MRTK v2
Eseguire la configurazione Eliminare MainCamera, aggiungere il prefab MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera alla scena o usare la voce di menu Mixed Reality Toolkit > Configure > Apply Mixed Reality Scene Settings (Applica impostazioni scena realtà mista). MainCamera padre in MixedRealityPlayspace tramite Mixed Reality Toolkit > Aggiungi alla scena e configura...
Configurazione Configurazione delle impostazioni della fotocamera eseguita nell'istanza di prefab. Impostazioni della fotocamera configurate nel profilo Fotocamera realtà mista.

Voce

Riconoscimento delle parole chiave

Metodi HTK 2017 MRTK v2
Eseguire la configurazione Aggiungere un oggetto SpeechInputSource alla scena. Il servizio parole chiave(ad esempio, Gestione input vocale Windows) deve essere aggiunto ai provider di dati del sistema di input.
Configurazione Le parole chiave riconosciute vengono configurate nel controllo SpeechInputSource. Le parole chiave vengono configurate nel profilo comandi vocali di realtà mista.
Gestori eventi ISpeechHandler IMixedRealitySpeechHandler

Dettatura

Metodi HTK 2017 MRTK v2
Eseguire la configurazione Aggiungere un elemento DictationInputManager alla scena. Il supporto per la dettatura richiede l'aggiunta del servizio (ad esempio Gestione input dettatura di Windows) ai provider di dati del sistema di input.
Gestori eventi IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Consapevolezza spaziale/mapping

Mesh

Metodi HTK 2017 MRTK v2
Eseguire la configurazione 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 nel profilo di ogni osservatore spaziale.

Aerei

Metodi HTK 2017 MRTK v2
Eseguire la configurazione Usare lo SurfaceMeshesToPlanes script . Non ancora implementato.

Comprensione spaziale

Metodi HTK 2017 MRTK v2
Eseguire la configurazione 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
Eseguire la configurazione 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
Eseguire la configurazione Servizio di condivisione: aggiungere il prefab condivisione alla scena. UNet: usare l'esempio SharingWithUNET. In corso
Configurazione Configurare le istanze della scena nel controllo. In corso

Ux

Metodi HTK 2017 MRTK v2
Pulsante Oggetti con interazione Button
Con interazione Oggetti con interazione Con interazione
Riquadro Riquadro Riquadro
Barra dell'app Barra dell'app Barra dell'app
Manipolazione di una mano (Grb e Move) HandDraggable Gestore di manipolazione
Manipolazione a due mani (grab/move/rotate/scale) TwoHandManipulatable Gestore di manipolazione
Tastiera Prefab della tastiera Tastiera di sistema
Descrizione comando Descrizione comando Descrizione comando
Raccolta di oggetti Raccolta di oggetti Raccolta di oggetti
Solver Solver Solver

Utilità

Alcune utilità sono state riconciliate come duplicati con il sistema del risolutore. Se uno degli script necessari non è presente, determinare un problema.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView o Orbital Risolutore
FixedAngularSize ConstantViewSizeRisolutore
FpsDisplay Sistema di diagnostica (nel profilo di configurazione)
NearFade Shader standard incorporato in Mixed Reality Toolkit