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 (.unitypackage) e tramite Unity Package Manager.
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 più grandi
- 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 Di base
La Realtà mista Toolkit Foundation è il set di codice che consente all'applicazione di sfruttare le funzionalità comuni nelle piattaforme Realtà mista.
Pacchetto mrTK Foundation
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 di 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 i dispositivi AR mobili. | |
| WindowsMixedReality | Supporto per i dispositivi Windows Mixed Reality, inclusi visori VR immersive e Microsoft HoloLens. | |
| 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 successive. | |
| MRTK/SDK | ||
| Sperimentale | Funzionalità sperimentali, inclusi shader, controlli dell'interfaccia utente e singoli gestori di sistema. | |
| Funzionalità | Funzionalità basate sul pacchetto Foundation. | |
| Profiles | 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 (spostamento dell'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/Extensions | ||
| 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 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/Strumenti | ||
| BuildWindow | Strumento che consente di semplificare il processo di compilazione e distribuzione di applicazioni UWP. | |
| DependencyWindow | Strumento che crea un grafico di dipendenza 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 le migliori prestazioni in Unity. | |
| ReserializeAssetsUtility | Fornisce il supporto per la rirializzazione 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 utilità di test
Il pacchetto facoltativo Microsoft.MixedRealityToolkit.TestUtilities è una raccolta di script helper che consentono agli sviluppatori di creare facilmente test in modalità play. 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à play, inclusi gli utilità di simulazione mano. |
Pacchetto di esempi
Il pacchetto di esempi contiene demo, script di esempio e scene di esempio che esercitano le funzionalità nel pacchetto di base. Questo pacchetto contiene la scena HandInteractionExample (immagine riportata di seguito) che contiene oggetti di esempio che rispondono a vari tipi di input della mano (articolati e non articolati).
Questo pacchetto contiene anche demo di rilevamento oculare, documentate qui
In genere, 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 Package Manager.
Alcuni dei vantaggi dell'uso dei pacchetti di asset includono:
- Progetti più piccoli
- Soluzioni Visual Studio più pulite
- Meno file da archiviare (MRTK è un riferimento semplice 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 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/Provider | Provider di dati agnostici della piattaforma | |
| Mani | Supporto della classe di base e servizi per il rilevamento delle mani. | |
| InputAnimation | Supporto per la registrazione dei dati di rilevamento della testa e della mano. | |
| InputSimulation | Supporto per la simulazione in-editor di input della mano e dell'occhio. | |
| ObjectMeshObserver | Osservatore della 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 i dispositivi AR mobili. | |
| WindowsMixedReality | Supporto per i dispositivi Windows Mixed Reality, inclusi visori VR immersive e Microsoft HoloLens. | |
| 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 successive. | |
| MRTK/SDK | ||
| Sperimentale | Funzionalità sperimentali, inclusi shader, controlli dell'interfaccia utente e singoli gestori di sistema. | |
| Funzionalità | Funzionalità basate sul pacchetto Foundation. | |
| Profiles | 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 (spostamento dell'esperienza nei salti). |
Dipendenze:
- Asset standard (
com.microsoft.mixedreality.toolkit.standardassets)
Asset standard
Il pacchetto 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
- Trame
- 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 per la fisica a 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 uniformi. | |
| Campioni~ | Cartella nascosta (nell'editor di Unity) che contiene le scene e gli asset di esempio. |
Per altre informazioni sul processo di utilizzo di pacchetti contenenti progetti di esempio, vedere l'articolo Realtà mista Toolkit e Unity Package Manager.
Dipendenze:
- Fondazione (
com.microsoft.mixedreality.toolkit.foundation)
Pacchetto 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 codice non viene fornito come parte di un'applicazione.
| Cartella | Componente | Descrizione |
|---|---|---|
| MRTK/Strumenti | ||
| 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 reinrializzazione 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:
- Fondazione (
com.microsoft.mixedreality.toolkit.foundation)
Pacchetto utilità di test
Il pacchetto di utilità di test facoltativo (com.microsoft.mixedreality.toolkit.testutilities) contiene una raccolta di script helper che consentono agli sviluppatori di creare facilmente test in modalità play. 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à play, inclusi gli utilità di simulazione mano. |
Dipendenze:
- Foundation (
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 uso di pacchetti contenenti progetti di esempio sono disponibili nell'articolo Realtà mista Toolkit e Unity Package Manager.
| 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:
- Foundation (
com.microsoft.mixedreality.toolkit.foundation) - Estensioni (
com.microsoft.mixedreality.toolkit.extensions)