Pacchetti MRTK - MRTK2
Realtà mista Toolkit (MRTK) è una raccolta di pacchetti che consentono lo sviluppo di applicazioni multipiattaforma Realtà mista fornendo supporto per Realtà mista hardware e piattaforme.
MRTK è disponibile come pacchetti asset (con estensione unitypackage) e tramite il Gestione pacchetti Unity.
Pacchetti di asset
L'asset MRTK (.unitypackage) può essere scaricato da GitHub.
Alcuni dei vantaggi dell'uso dei pacchetti di asset includono:
- Disponibile per Unity 2018.4 e versioni successive
- Facile da apportare modifiche a MRTK
- MRTK si trova nella cartella Assets
Alcuni di questi problemi sono:
- MRTK fa parte della cartella Assets del progetto, che porta a
- 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 (3000+ file)
- Rischio di perdita di modifiche apportate a MRTK
- L'importazione del pacchetto di esempi significa in genere includere tutti gli esempi
I pacchetti disponibili sono:
Questi pacchetti vengono rilasciati e supportati da Microsoft dal codice sorgente in GitHub.
Pacchetto Foundation
Realtà mista Toolkit Foundation è il set di codice che consente all'applicazione di sfruttare le funzionalità comuni tra le piattaforme Realtà mista.
Pacchetto MRTK Foundation
Il pacchetto MRTK Foundation contiene quanto segue.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Core | Definizioni di interfaccia e tipi, classi di base, shader standard. | |
| MRTK/Core/Providers | Provider di dati indipendenti dalla piattaforma | |
| Mani | Supporto e servizi della classe base per il tracciamento manuale. | |
| InputAnimation | Supporto per la registrazione del movimento della testa e dei dati di tracciamento della mano. | |
| InputSimulation | Supporto per la simulazione nell'editor dell'input manuale e oculare. | |
| ObjectMeshObserver | Osservatore di consapevolezza spaziale usando un modello 3D come dati. | |
| UnityInput | Dispositivi di input comuni (joystick, 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 i 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 i dispositivi Windows Realtà mista, inclusi Microsoft HoloLens e visori VR immersive. | |
| Finestre | 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 successive. | |
| MRTK/SDK | ||
| Sperimentale | Funzionalità sperimentali, inclusi shader, controlli dell'interfaccia utente e singoli gestori di sistema. | |
| Funzionalità | Funzionalità basate sul pacchetto Foundation. | |
| Profili | Profili predefiniti per i sistemi e i servizi di Microsoft Realtà mista 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 VR. | |
| CameraSystem | Sistema che implementa la configurazione e la gestione della fotocamera. | |
| DiagnosticsSystem | Implementazione del sistema nella diagnostica dell'applicazione, 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 | Il sistema fornisce supporto per la consapevolezza dell'ambiente dell'utente. | |
| TeleportSystem | Sistema che fornisce supporto per il teletrasportamento (spostando l'esperienza nei 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 la funzionalità di Microsoft Realtà mista 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 rilevamento nei dispositivi Microsoft HoloLens. | |
| SceneTransitionService | Servizio che semplifica l'aggiunta di transizioni di scena fluide. |
Pacchetto degli strumenti
Il pacchetto facoltativo Microsoft.MixedRealityToolkit.Unity.Tools include strumenti utili che migliorano l'esperienza di sviluppo di realtà mista usando Microsoft Realtà mista Toolkit. Questi strumenti si trovano nel menu Realtà mista Toolkit > Utilities nell'editor di Unity.
Nota
Il pacchetto degli strumenti richiede Microsoft.MixedRealityToolkit.Unity.Foundation.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Tools | ||
| BuildWindow | Strumento che semplifica il processo di compilazione e distribuzione di applicazioni UWP. | |
| DependencyWindow | Strumento che crea un grafico delle dipendenze degli 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à per automatizzare la configurazione di un progetto di realtà mista per ottenere prestazioni ottimali in Unity. | |
| ReserializeAssetsUtility | Fornisce il supporto per la reinizializzazione 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 delle 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 UX di 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/Test | ||
| TestUtilities | Metodi per semplificare la creazione di test in modalità di riproduzione, incluse le utilità di simulazione manuale. |
Pacchetto di esempi
Il pacchetto di esempi contiene demo, script di esempio e scene di esempio che esercitano la funzionalità nel pacchetto di base. Questo pacchetto contiene la scena HandInteractionExample (illustrato di seguito) che contiene oggetti di esempio che rispondono a vari tipi di input manuale (articolati e non articolati).
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 di esempi, seguendo approssimativamente la stessa struttura di cartelle e la stessa posizione.
Nota
Il pacchetto di 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. |
Gestione pacchetti unity
Per le esperienze create con Unity 2019.4 e versioni successive, MRTK è disponibile tramite unity Gestione pacchetti.
Alcuni dei vantaggi dell'uso dei pacchetti di asset includono:
- Progetti più piccoli
- Soluzioni Di Visual Studio più pulite
- Minor numero di file da archiviare (MRTK è un semplice riferimento nel
Packages/manifest.jsonfile)
- 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.jsonfile
- Modificare la versione nel
Alcuni di questi problemi sono:
- MRTK non modificabile
- Impossibile apportare modifiche senza rimuoverle 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 Realtà mista Toolkit.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Core | Definizioni di interfaccia e tipi, classi di base, shader standard. | |
| MRTK/Core/Providers | Provider di dati indipendenti dalla piattaforma | |
| Mani | Supporto e servizi della classe base per il tracciamento manuale. | |
| InputAnimation | Supporto per la registrazione del movimento della testa e dei dati di tracciamento della mano. | |
| InputSimulation | Supporto per la simulazione nell'editor dell'input manuale e oculare. | |
| ObjectMeshObserver | Osservatore di consapevolezza spaziale usando un modello 3D come dati. | |
| UnityInput | Dispositivi di input comuni (joystick, 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 i 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 i dispositivi Windows Realtà mista, inclusi Microsoft HoloLens e visori VR immersive. | |
| Finestre | 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 successive. | |
| MRTK/SDK | ||
| Sperimentale | Funzionalità sperimentali, inclusi shader, controlli dell'interfaccia utente e singoli gestori di sistema. | |
| Funzionalità | Funzionalità basate sul pacchetto Foundation. | |
| Profili | Profili predefiniti per i sistemi e i servizi di Microsoft Realtà mista Toolkit. | |
| StandardAssets | Asset comuni; modelli, trame, materiali e così via. | |
| MRTK/Services | ||
| BoundarySystem | Sistema che implementa il supporto dei limiti VR. | |
| CameraSystem | Sistema che implementa la configurazione e la gestione della fotocamera. | |
| DiagnosticsSystem | Implementazione del sistema nella diagnostica dell'applicazione, 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 | Il sistema fornisce supporto per la consapevolezza dell'ambiente dell'utente. | |
| TeleportSystem | Sistema che fornisce supporto per il teletrasportamento (spostando l'esperienza nei salti). |
Dipendenze:
- Asset standard (
com.microsoft.mixedreality.toolkit.standardassets)
Asset standard
Il pacchetto di asset standard (com.microsoft.mixedreality.toolkit.standardassets) è una raccolta di componenti consigliati per tutte le esperienze di realtà mista, tra cui:
- Shader MRTK Standard
- Materiali di base che usano lo shader MRTK Standard
- File audio
- Tipi di carattere
- Texture
- Icone
Nota
Per evitare modifiche di rilievo in base alle definizioni di assembly, gli script usati per controllare alcune funzionalità dello shader MRTK Standard 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 facoltative (com.microsoft.mixedreality.toolkit.extensions) contiene componenti aggiuntivi che espandono la funzionalità di MRTK.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Estensioni | ||
| HandPhysicsService | Servizio che aggiunge il supporto fisico alle mani articolate. | |
| LostTrackingService | Servizio che semplifica la gestione della perdita di rilevamento nei dispositivi Microsoft HoloLens. | |
| SceneTransitionService | Servizio che semplifica l'aggiunta di transizioni di scena fluide. | |
| Campioni~ | Cartella nascosta (nell'editor di Unity) che contiene le scene e gli asset di esempio. |
Altre informazioni sul processo di utilizzo di pacchetti contenenti progetti di esempio sono disponibili nell'articolo Realtà mista Toolkit e Unity Gestione pacchetti.
Dipendenze:
- Fondazione (
com.microsoft.mixedreality.toolkit.foundation)
Pacchetto degli strumenti
Il pacchetto facoltativo degli strumenti (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 fornito come parte di un'applicazione.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Tools | ||
| BuildWindow | Strumento che semplifica il processo di compilazione e distribuzione di applicazioni UWP. | |
| DependencyWindow | Strumento che crea un grafico delle dipendenze degli 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à per automatizzare la configurazione di un progetto di realtà mista per ottenere prestazioni ottimali in Unity. | |
| ReserializeAssetsUtility | Fornisce il supporto per la reinizializzazione 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 delle 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 UX di MRTK. |
Dipendenze:
- Fondazione (
com.microsoft.mixedreality.toolkit.foundation)
Pacchetto di utilità di test
Il pacchetto facoltativo utilità di test (com.microsoft.mixedreality.toolkit.testutilities) contiene 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/Test | ||
| TestUtilities | Metodi per semplificare la creazione di test in modalità di riproduzione, incluse le utilità di simulazione manuale. |
Dipendenze:
- Fondazione (
com.microsoft.mixedreality.toolkit.foundation)
Pacchetto di esempi
Il pacchetto di esempi (com.microsoft.mixedreality.toolkit.examples) è strutturato per consentire agli sviluppatori di importare solo gli esempi di interesse.
Altre informazioni sul processo di utilizzo di pacchetti contenenti progetti di esempio sono disponibili nell'articolo Realtà mista Toolkit e Unity Gestione pacchetti.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Esempi | ||
| Campioni~ | Cartella nascosta (nell'editor di Unity) che contiene le scene e gli asset di esempio. | |
| StandardAssets | Asset comuni condivisi da più scene demo. |
Dipendenze:
- Fondazione (
com.microsoft.mixedreality.toolkit.foundation) - Estensioni (
com.microsoft.mixedreality.toolkit.extensions)