Pacchetti di Mixed Reality Toolkit

Mixed Reality Toolkit (MRTK) è una raccolta di pacchetti che consentono lo sviluppo di applicazioni di realtà mista multipiattaforma fornendo supporto per hardware e piattaforme di realtà mista.

MRTK è disponibile come pacchetti di asset (con estensione unitypackage) e tramite unity Gestione pacchetti.

Pacchetti di asset

L'asset MRTK (con estensione unitypackage) può essere scaricato da GitHub.

Di seguito sono elencati alcuni dei vantaggi offerti dall'uso dei pacchetti di asset:

  • Disponibile per Unity 2018.4 e versione più recente
  • Facilità di apportare modifiche a MRTK
    • MRTK si trova nella cartella Assets

Alcuni di questi problemi sono:

  • MRTK fa parte della cartella Assets del progetto, causando
    • Progetti di dimensioni maggiori
    • Tempi di compilazione più lenti
  • Nessuna gestione delle dipendenze
    • I clienti devono risolvere manualmente le dipendenze dei pacchetti
  • Processo di aggiornamento manuale
    • Più passaggi
    • Aggiornamenti del controllo del codice sorgente di grandi dimensioni (oltre 3000 file)
    • Rischio di perdita delle modifiche apportate a MRTK
  • L'importazione del pacchetto examples in genere significa includere tutti gli esempi

I pacchetti disponibili sono:

Questi pacchetti vengono rilasciati e supportati da Microsoft dal codice sorgente nel ramo mrtk_release su GitHub.

Pacchetto Di base

Mixed Reality Toolkit Foundation è il set di codice che consente all'applicazione di sfruttare le funzionalità comuni tra piattaforme di realtà mista.

Pakage foundation Pacchetto DI BASE MRTK

Il pacchetto MRTK Foundation contiene quanto segue.

Cartella Componente Descrizione
MRTK/Core Definizioni di interfaccia e tipo, classi di base, shader standard.
MRTK/Core/Providers Provider di dati indipendenti dalla piattaforma
Mani Supporto e servizi della classe base per il rilevamento manuale.
InputAnimation Supporto per la registrazione dei dati di spostamento della testa e rilevamento della mano.
InputSimulation Supporto per la simulazione nell'editor dell'input di mani e occhi.
ObjectMeshObserver Osservatore di consapevolezza spaziale che usa un modello 3D come dati.
UnityInput Dispositivi di input comuni (a levetta, mouse e così via) implementati tramite l'API di input di Unity.
MRTK/Providers Provider di dati specifici della piattaforma
LeapMotion Supporto per il controller UltraLeap Leap Motion.
OpenVR Supporto per dispositivi OpenVR.
Oculus Supporto per i dispositivi Oculus, ad esempio quest.
UnityAR (Sperimentale) Provider di impostazioni della fotocamera che abilita l'uso di MRTK con dispositivi AR mobili.
WindowsMixedReality Supporto per Windows Mixed Reality, inclusi visori VR Microsoft HoloLens immersive.
Windows Supporto per API specifiche di Microsoft Windows, ad esempio riconoscimento vocale e dettatura.
XR SDK (Sperimentale) Supporto per il nuovo framework XR di Unity in Unity 2019.3 e versioni più recente.
MRTK/SDK
Sperimentale Funzionalità sperimentali, inclusi shader, controlli dell'interfaccia utente e singoli gestori di sistema.
Funzionalità Funzionalità che si basa sul pacchetto Foundation.
Profiles Profili predefiniti per i sistemi e i servizi di Microsoft Mixed Reality Toolkit.
StandardAssets Asset comuni; modelli, trame, materiali e così via.
MRTK/SceneSystemResources Asset e risorse usati dal sistema scene
MRTK/Services
BoundarySystem Sistema che implementa il supporto dei limiti di realtà virtuale.
CameraSystem Sistema che implementa la configurazione e la gestione della fotocamera.
DiagnosticsSystem Implementazione del sistema nella diagnostica delle applicazioni, ad esempio un profiler visivo.
InputSystem Sistema che fornisce supporto per l'accesso e la gestione dell'input dell'utente.
SceneSystem Sistema che fornisce supporto per applicazioni multi-scena.
SpatialAwarenessSystem Sistema che fornisce supporto per la consapevolezza dell'ambiente dell'utente.
TeleportSystem Sistema che fornisce supporto per il teletrasporto (spostamento dell'esperienza in salti).
MRTK/StandardAssets Shader MRTK Standard, materiali di base e altri asset standard per esperienze di realtà mista

Pacchetto di estensioni

Il pacchetto facoltativo Microsoft.MixedRealityToolkit.Unity.Extensions include servizi aggiuntivi che estendono le funzionalità di Microsoft Mixed Reality Toolkit.

Nota

Il pacchetto di estensioni richiede Microsoft.MixedRealityToolkit.Unity.Foundation.

Cartella Componente Descrizione
MRTK/Estensioni
HandPhysicsService Servizio che aggiunge il supporto fisico alle mani articolate.
LostTrackingService Servizio che semplifica la gestione della perdita di tracciabilità Microsoft HoloLens dispositivi.
SceneTransitionService Servizio che semplifica l'aggiunta di transizioni di scena uniformi.

Pacchetto tools

Il pacchetto facoltativo Microsoft.MixedRealityToolkit.Unity.Tools include strumenti utili che migliorano l'esperienza di sviluppo di realtà mista con Microsoft Mixed Reality Toolkit. Questi strumenti si trovano nel menu Mixed Reality Toolkit > Utilities nell'editor di Unity.

Nota

Il pacchetto di strumenti richiede Microsoft.MixedRealityToolkit.Unity.Foundation.

Cartella Componente Descrizione
MRTK/Strumenti
Finestra di compilazione Strumento che semplifica il processo di compilazione e distribuzione di applicazioni UWP.
DependencyWindow Strumento che crea un grafo delle dipendenze di asset in un progetto.
ExtensionServiceCreator Procedura guidata per facilitare la creazione di servizi di estensione.
MigrationWindow Strumento che consente di aggiornare il codice che usa componenti MRTK deprecati.
OptimizeWindow Utilità che consente di automatizzare la configurazione di un progetto di realtà mista per ottenere prestazioni ottimali in Unity.
ReserializeAssetsUtility Fornisce il supporto per la deserializzazione di file Unity specifici.
RuntimeTools/Tools/ControllerMappingTool Utilità che consente agli sviluppatori di determinare rapidamente i mapping di Unity per i controller hardware.
ScreenshotUtility Abilita l'acquisizione di immagini dell'applicazione nell'editor di Unity.
TextureCombinerWindow Utilità per combinare trame grafiche.
Casella degli strumenti Interfaccia utente che semplifica l'individuazione e l'uso dei componenti dell'esperienza utente MRTK.

Pacchetto di utilità di test

Il pacchetto facoltativo Microsoft.MixedRealityToolkit.TestUtilities è una raccolta di script helper che consentono agli sviluppatori di creare facilmente test in modalità di riproduzione. Queste utilità sono particolarmente utili per gli sviluppatori che creano componenti MRTK.

Cartella Componente Descrizione
MRTK/Tests
TestUtilities Metodi per semplificare la creazione di test in modalità di riproduzione, incluse le utilità di simulazione manuale.

Pacchetto di esempi

Il pacchetto degli esempi contiene demo, script di esempio e scene di esempio che esercitino la funzionalità nel pacchetto di base. Questo pacchetto contiene la scena HandInteractionExample (nella figura seguente) che contiene oggetti di esempio che rispondono a vari tipi di input manuale (articolati e non articolati).

Scena HandInteractionExample

Questo pacchetto contiene anche demo di tracciamento oculare, documentate qui

Più in generale, qualsiasi nuova funzionalità in MRTK deve contenere un esempio corrispondente nel pacchetto degli esempi, seguendo approssimativamente la stessa struttura di cartelle e la stessa posizione.

Nota

Il pacchetto degli esempi richiede Microsoft.MixedRealityToolkit.Unity.Foundation.

Cartella Componente Descrizione
MRTK/Esempi
Demo Scene semplici che illustrano una o due funzionalità correlate.
Sperimentale Scene demo che illustrano le funzionalità sperimentali.
StandardAssets Asset comuni condivisi da più scene demo.

Unity Gestione pacchetti

Per le esperienze create con Unity 2019.4 e versione più recente, MRTK è disponibile tramite unity Gestione pacchetti.

Alcuni dei vantaggi dell'uso dei pacchetti di asset includono:

  • Progetti più piccoli
    • Soluzioni Visual Studio più pulite
    • Meno file da archiviare (MRTK è un semplice riferimento nel Packages/manifest.json file)
  • Compilazione più veloce
    • Unity non deve ricompilare MRTK durante la compilazione
  • Risoluzione delle dipendenze
    • I pacchetti MRTK necessari vengono installati automaticamente quando si specificano pacchetti con dipendenze
  • Aggiornamento semplice alle nuove versioni di MRTK
    • Modificare la versione nel Packages/manifest.json file

Alcuni di questi problemi sono:

  • MRTK non è modificabile
    • Non è possibile apportare modifiche senza che vengano rimosse durante la risoluzione del pacchetto
  • MRTK non supporta i pacchetti UPM con Unity 2018.4

Pacchetto Foundation

Il pacchetto di base ( com.microsoft.mixedreality.toolkit.foundation ) costituisce la base di Mixed Reality Toolkit.

Cartella Componente Descrizione
MRTK/Core Definizioni di interfaccia e tipo, classi di base, shader standard.
MRTK/Core/Providers Provider di dati indipendenti dalla piattaforma
Mani Supporto della classe di base e servizi per il tracciamento delle mani.
InputAnimation Supporto per la registrazione dei dati di movimento della testa e tracciamento della mano.
InputSimulation Supporto per la simulazione nell'editor dell'input manuale e oculare.
ObjectMeshObserver Osservatore di consapevolezza spaziale che usa un modello 3D come dati.
UnityInput Dispositivi di input comuni (a levetta, mouse e così via) implementati tramite l'API di input di Unity.
MRTK/Providers Provider di dati specifici della piattaforma
LeapMotion Supporto per il controller UltraLeap Leap Motion.
OpenVR Supporto per dispositivi OpenVR.
Oculus Supporto per i dispositivi Oculus, ad esempio quest.
UnityAR (Sperimentale) Provider di impostazioni della fotocamera che abilita l'uso di MRTK con dispositivi AR mobili.
WindowsMixedReality Supporto per Windows Mixed Reality, inclusi visori VR Microsoft HoloLens immersive.
Windows Supporto per API specifiche di Microsoft Windows, ad esempio riconoscimento vocale e dettatura.
XR SDK (Sperimentale) Supporto per il nuovo framework XR di Unity in Unity 2019.3 e versioni più recente.
MRTK/SDK
Sperimentale Funzionalità sperimentali, inclusi shader, controlli dell'interfaccia utente e singoli gestori di sistema.
Funzionalità Funzionalità che si basa sul pacchetto Foundation.
Profiles Profili predefiniti per i sistemi e i servizi di Microsoft Mixed Reality Toolkit.
StandardAssets Asset comuni; modelli, trame, materiali e così via.
MRTK/Services
BoundarySystem Sistema che implementa il supporto dei limiti di realtà virtuale.
CameraSystem Sistema che implementa la configurazione e la gestione della fotocamera.
DiagnosticsSystem Implementazione del sistema nella diagnostica delle applicazioni, ad esempio un profiler visivo.
InputSystem Sistema che fornisce supporto per l'accesso e la gestione dell'input dell'utente.
SceneSystem Sistema che fornisce supporto per applicazioni multi-scena.
SpatialAwarenessSystem Sistema che fornisce supporto per la consapevolezza dell'ambiente dell'utente.
TeleportSystem Sistema che fornisce supporto per il teletrasporto (spostamento dell'esperienza in salti).

Dipendenze:

  • Asset standard ( com.microsoft.mixedreality.toolkit.standardassets )

Asset standard

Il pacchetto di asset standard ( è una raccolta di componenti consigliati per tutte le esperienze com.microsoft.mixedreality.toolkit.standardassets) di realtà mista, tra cui:

  • Shader STANDARD MRTK
  • Materiali di base con lo shader MRTK Standard
  • File audio
  • Tipi di carattere
  • Trame
  • Icone

Nota

Per evitare modifiche di rilievo basate sulle definizioni di assembly, gli script usati per controllare alcune funzionalità dello shader STANDARD MRTK non sono inclusi nel pacchetto di asset standard. Questi script sono disponibili nel pacchetto di base nella MRTK/Core/Utilities/StandardShader cartella .

Dipendenze: nessuna

Pacchetti di estensione

Il pacchetto di estensioni facoltativo ( com.microsoft.mixedreality.toolkit.extensions) contiene componenti aggiuntivi che espandono le funzionalità di MRTK.

Cartella Componente Descrizione
MRTK/Extensions
HandPhysicsService Servizio che aggiunge il supporto fisico alle mani articolate.
LostTrackingService Servizio che semplifica la gestione della perdita di rilevamento Microsoft HoloLens dispositivi.
SceneTransitionService Servizio che semplifica l'aggiunta di transizioni di scena uniformi.
Esempi~ Cartella nascosta (nell'editor unity) che contiene le scene e gli asset di esempio.

Altre informazioni sul processo di uso dei pacchetti contenenti progetti di esempio sono disponibili nell'articolo Mixed Reality Toolkit e Unity Gestione pacchetti.

Dipendenze:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

Pacchetto tools

Il pacchetto di strumenti facoltativo ( com.microsoft.mixedreality.toolkit.tools) contiene strumenti utili per la creazione di esperienze di realtà mista. In generale, questi strumenti sono componenti dell'editor e il relativo codice non viene specificato come parte di un'applicazione.

Cartella Componente Descrizione
MRTK/Strumenti
Finestra di compilazione Strumento che semplifica il processo di compilazione e distribuzione di applicazioni UWP.
Finestra di dipendenza Strumento che crea un grafico delle dipendenze degli asset in un progetto.
ExtensionServiceCreator Procedura guidata per facilitare la creazione di servizi di estensione.
Finestra di migrazione Strumento che consente di aggiornare il codice che usa componenti MRTK deprecati.
OptimizeWindow Utilità che consente di automatizzare la configurazione di un progetto di realtà mista per ottenere prestazioni ottimali in Unity.
ReserializeAssetsUtility Fornisce supporto per la deserializzazione di file Unity specifici.
RuntimeTools/Tools/ControllerMappingTool Utilità che consente agli sviluppatori di determinare rapidamente i mapping di Unity per i controller hardware.
ScreenshotUtility Abilita l'acquisizione di immagini dell'applicazione nell'editor di Unity.
TextureCombinerWindow Utilità per combinare trame grafiche.
Casella degli strumenti Interfaccia utente che semplifica l'individuazione e l'uso dei componenti dell'esperienza utente MRTK.

Dipendenze:

  • Base ( com.microsoft.mixedreality.toolkit.foundation )

Pacchetto di utilità di test

Il pacchetto di utilità di test facoltativo ( ) contiene una raccolta di script helper che consentono agli sviluppatori com.microsoft.mixedreality.toolkit.testutilities di creare facilmente test in modalità di riproduzione. Queste utilità sono particolarmente utili per gli sviluppatori che creano componenti MRTK.

Cartella Componente Descrizione
MRTK/Tests
TestUtilities Metodi per semplificare la creazione di test in modalità di riproduzione, incluse le utilità di simulazione manuale.

Dipendenze:

  • Base ( com.microsoft.mixedreality.toolkit.foundation )

Pacchetto di esempi

Il pacchetto degli esempi ( com.microsoft.mixedreality.toolkit.examples ), è strutturato per consentire agli sviluppatori di importare solo gli esempi di interesse.

Per altre informazioni sul processo di uso dei pacchetti contenenti progetti di esempio, vedere l'articolo Mixed Reality Toolkit e Unity Gestione pacchetti.

Cartella Componente Descrizione
MRTK/Esempi
Esempi~ Cartella nascosta (nell'editor unity) che contiene le scene e gli asset di esempio.
StandardAssets Asset comuni condivisi da più scene demo.

Dipendenze:

  • Base ( com.microsoft.mixedreality.toolkit.foundation )
  • Estensioni (com.microsoft.mixedreality.toolkit.extensions)

Vedi anche