Condividi tramite


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 Foundationdi Pakage 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).

Scena HandInteractionExample

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.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 MRTK
    • Modificare la versione nel Packages/manifest.json file

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)

Vedi anche