Configurare un nuovo progetto OpenXR con MRTK

  • Articolo

Il modo più semplice per configurare il progetto Unity per la realtà mista consiste nell'usare Realtà mista Toolkit (MRTK). MRTK per Unity è un kit di sviluppo multipiattaforma open source progettato per semplificare la creazione di incredibili applicazioni di realtà mista.

Infografica che mostra alcune delle funzionalità di Realtà mista Toolkit.

MRTK offre un sistema di input multipiattaforma, componenti di base e blocchi predefiniti comuni per le interazioni spaziali. Consente di velocizzare lo sviluppo di applicazioni per Microsoft HoloLens, Windows Mixed Reality visori VR immersive e molti altri dispositivi VR/AR. Il progetto mira a ridurre le barriere all'ingresso, consentendo a tutti di creare applicazioni di realtà mista e contribuire alla community man mano che tutti creiamo.

MRTK supporta un'ampia gamma di piattaforme, tra cui:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Visori VR di Windows Mixed Reality

  • Visori VR di OpenVR (HTC Vive/Oculus Rift)

  • Tracciamento della mano Ultraleap

  • Dispositivi Android e iOS

Nota

Di recente è stato introdotto MRTK3, la terza generazione di Microsoft Realtà mista Toolkit per Unity basata sul sistema XR Management di Unity e XR Interaction Toolkit, con un supporto migliore per un'ampia gamma di dispositivi conformi a OpenXR e un nuovo linguaggio di progettazione. Per altre informazioni, vedere la documentazione di MRTK3.

Nota

È anche possibile configurare un nuovo progetto OpenXR senza MRTK.

Altre opzioni di configurazione non OpenXR da considerare

Windows XR: Microsoft non consiglia di usare il plug-in Windows XR per i nuovi progetti in Unity 2020. È invece consigliabile usare il plug-in OpenXR Realtà mista. Tuttavia, se si usa Unity 2019 ed è necessario AR Foundation 2.0 per la compatibilità con i dispositivi ARCore/ARKit, questo plug-in abilita tale supporto.

Importante

L'uso di questo plug-in in Unity 2019 non è compatibile con Ancoraggi nello spazio di Azure.

XR legacy:

Se si usa ancora Unity 2019 o versioni precedenti, Microsoft consiglia di usare il supporto XR predefinito legacy. Anche se il plug-in Windows XR è funzionante in Unity 2019, non è consigliabile perché non è compatibile con Ancoraggi nello spazio di Azure in Unity 2019.

Se si avvia un nuovo progetto, è consigliabile installare Unity 2020 e usare il plug-in OpenXR Realtà mista.

Introduzione a OpenXR: Creare un nuovo progetto Unity

  1. Avviare l'hub Unity.

  2. Nella scheda Progetti fare clic su Nuovo progetto.

    Screenshot della scheda Projects in Unity Hub con il pulsante New project evidenziato.

  3. Fare clic sull'elenco a discesa sotto Nuovo progetto e quindi selezionare la versione dell'editor desiderata.

    Screenshot di Unity Hub con il menu a discesa Editor Version visualizzato.

  4. Verificare che il modello scelto sia 3D Core.

  5. Nella casella Nome progetto immettere un nome per il progetto, ad esempio "Esercitazione MRTK".

  6. Nella casella Percorso fare clic sull'icona della cartella e quindi passare alla cartella in cui si vuole salvare il progetto e selezionarlo. È anche possibile creare una nuova cartella.

    Screenshot di Unity Hub con 3D, Project name, Location e Create project evidenziati.

  7. Fare clic su Crea progetto. Il progetto verrà aperto in Unity.

    Screenshot del progetto aperto in Unity.

Attenzione

Quando si lavora in Windows, è previsto un limite di MAX_PATH di 255 caratteri. Questi limiti si applicano in Unity e la compilazione può avere esito negativo se un percorso di file supera i 255 caratteri. È quindi consigliabile archiviare il progetto Unity il più vicino possibile alla radice dell'unità.

Impostare la destinazione di compilazione

  1. Sulla barra dei menu scegliere File>Build Settings (Impostazioni di compilazione).

    Per compilare un'app per Windows Mixed Reality, è necessario scegliere una destinazione di compilazione. Le impostazioni di compilazione per piattaforma UWP (Universal Windows Platform) (UWP) sono destinate a qualsiasi dispositivo, inclusi visori VR immersive come HP Reverb G2. Questa è la scelta migliore se si sta creando per il HoloLens 2; tuttavia, se si ha come destinazione desktop VR, è consigliabile usare il PC, Mac & piattaforma autonoma Linux.

  2. Eseguire una delle operazioni seguenti:

    Se hai come destinazione Desktop VR:

    • Mantenere il PC, Mac & piattaforma autonoma Linux selezionata per impostazione predefinita in un nuovo progetto Unity:

    Screenshot della finestra Impostazioni di compilazione aperta nell'editor unity con PC, Mac & piattaforma autonoma evidenziata

    Se si ha come destinazione il HoloLens 2:

    • In Piattaforma selezionare piattaforma UWP (Universal Windows Platform). Assicurarsi che le impostazioni seguenti siano attive:

    Tipo di compilazione: Progetto D3D

    Versione dell'SDK di destinazione: ultima installata

    Versione minima della piattaforma: 10.0.10240.0

    Versione di Visual Studio: ultima installata

    Screenshot della finestra Impostazioni di compilazione aperta nell'editor unity con piattaforma UWP (Universal Windows Platform) evidenziato.

  3. Premere il pulsante Cambia piattaforma. Unity visualizza un indicatore di stato mentre cambia piattaforma.

  4. Al termine del processo di cambio della piattaforma, chiudere la finestra Impostazioni di compilazione.

Scaricare e installare lo strumento di funzionalità Realtà mista

Il plug-in OpenXR Realtà mista è disponibile sotto forma di pacchetto per Unity. Il modo migliore per individuare, aggiornare e importare pacchetti di funzionalità è con lo strumento di funzionalità Realtà mista. È possibile cercare i pacchetti in base al nome o alla categoria, visualizzarne le dipendenze e vedere le modifiche proposte al file manifesto del progetto prima dell'importazione.

  1. Scaricare la versione più recente dello strumento di funzionalità Realtà mista dall'Area download Microsoft.

  2. Al termine del download, passare al file eseguibile MixedRealityFeatureTool.exe e quindi usarlo per avviare lo strumento Realtà mista funzionalità.

    Screenshot dell'apertura di MixedRealityFeatureTool.

Importare i pacchetti Realtà mista Toolkit e OpenXR

  1. Nello Strumento per la funzionalità di realtà mista selezionare Avvia.

    Screenshot della schermata di apertura di Mixed Reality Feature Tool.

  2. Selezionare il pulsante Sfoglia, ovvero il pulsante con "tre punti" nell'immagine seguente, quindi passare al progetto e aprirlo.

    Aprire il progetto

    Nota

    La casella Percorso progetto nello strumento deve contenere un valore, quindi inserisce una barra rovesciata ("_") per impostazione predefinita.

    Dopo aver selezionato una cartella, lo strumento esegue dei controlli per assicurarsi che si tratti di una cartella di progetto Unity valida.

    Screenshot della schermata del percorso del progetto in Mixed Reality Feature Tool.

  3. Selezionare Discover Features.

    Nota: potrebbe essere necessario attendere alcuni secondi mentre lo strumento aggiorna i pacchetti dai feed.

  4. Nella pagina Discover Features si noti la presenza di un elenco di sei gruppi di pacchetti.

    Gruppi principali di pacchetti in Mixed Reality Feature Tool

  5. Fare clic sul pulsante "+" a sinistra di Mixed Reality Toolkit (0 of 10), quindi selezionare la versione più recente di Mixed Reality Toolkit Foundation.

    Nota

    Il pacchetto Mixed Reality Toolkit Foundation è l'unico pacchetto che è obbligatorio importare e configurare per usare il Toolkit di Realtà Mista con un progetto. Questo pacchetto include i componenti principali necessari per creare un'applicazione di realtà mista.

  6. Fare clic sul pulsante "+" a sinistra di Platform Support (0 of 5), quindi selezionare la versione più recente di Mixed Reality OpenXR Plugin.

    Screenshot delle selezioni di pacchetti in Mixed Reality Feature Tool.

  7. Dopo aver effettuato le selezioni, fare clic su Get Features.

  8. Selezionare Convalidare per convalidare i pacchetti selezionati. Verrà visualizzata una finestra di dialogo che indica che non sono stati rilevati problemi di convalida. A questo punto, fare clic su OK.

  9. Nella pagina Import Features la colonna a sinistra Funzionalità mostra i pacchetti appena selezionati. Nella colonna a destra Dipendenze obbligatorie mostra tutte le dipendenze. È possibile fare clic sul collegamento Dettagli di uno di questi elementi per altre informazioni su di esse.

  10. Quando si è pronti per continuare, selezionare Importa. Nella pagina Verifica e approva è possibile esaminare le informazioni sui pacchetti.

  11. Selezionare Approva.

  12. Tornare all'editor di Unity e fare clic su un'area vuota nell'interfaccia utente. Verrà visualizzato un indicatore di stato che mostra che i pacchetti vengono importati.

Configurare le impostazioni back-end di input

  1. Dopo aver importato il pacchetto, viene visualizzato un avviso che chiede se si desidera abilitare i back-end riavviando l'editor. Selezionare Sì.

    Screenshot dell'opzione di riavvio di Unity.

Configurare il progetto per il HoloLens 2 tramite convalida del progetto (MR OpenXR 1.6+)

Se si sta sviluppando per desktop VR, ignorare questa sezione e passare a Configurare il progetto per desktop VR.

  1. Nella barra dei menu fare clic su Realtà mista Impostazioni > di convalida progetto HoloLens 2 > applicazione (UWP) per abilitare le regole di convalida per HoloLens 2. Per i plug-in MR OpenXR prima della versione 1.9, la voce di menu disponibile è Realtà mista Project > Apply consigliate impostazioni di progetto per HoloLens 2>.
  2. Nella finestra di convalida del progetto visualizzata, assicurarsi di essere nella scheda della piattaforma UWP (indicata dal logo di Windows) e fare clic su Correzione tutti per risolvere i problemi di convalida. Si noti che potrebbero verificarsi problemi che rimangono dopo aver fatto clic su Correzione di tutti. In questo caso, provare a fare clic su Correzione tutto , ignorare eventuali problemi contrassegnati come "specifici della scena" (se presente) e passare attraverso il resto dei problemi (se presenti) per verificare se sono presenti modifiche suggerite che si desidera apportare.
  3. Il progetto è quasi pronto per la distribuzione HoloLens 2 a questo punto. Passare a Configurare le impostazioni del lettore per il passaggio successivo.

Configurare il progetto per il HoloLens 2 manualmente

Se si sta sviluppando per desktop VR, ignorare questa sezione e passare a Configurare il progetto per desktop VR.

  1. Assicurarsi che la finestra Impostazioni progetto sia aperta. In caso contrario, nella barra dei menu selezionare Modifica>impostazioni progetto.

  2. Nella finestra Impostazioni progetto assicurarsi di essere nella pagina Gestione plug-in XR e nella scheda piattaforma UWP (Universal Windows Platform).

    Screenshot della finestra Project Settings aperta nella pagina XR Plugin Management, con la scheda per la piattaforma UWP visualizzata.

  3. Assicurarsi che inizializzare XR in Avvio sia selezionato e quindi, in Provider di plug-in, fare clic su OpenXR.

    Screenshot della finestra Impostazioni progetto, all'interno della piattaforma UWP (Universal Windows Platform), con Inizializza XR nell'avvio selezionato e il plug-in OpenXR evidenziato.

  4. Il plug-in OpenXR viene caricato e quindi vengono visualizzati più elementi sotto OpenXR. Selezionare Microsoft HoloLens gruppo di funzionalità.

    Screenshot della finestra Impostazioni progetto con il plug-in OpenXR e il gruppo di funzionalità Microsoft HoloLens evidenziato.

Si noti che è presente un triangolo di avviso giallo accanto a OpenXR. Ciò indica che sono presenti impostazioni incompatibili che devono essere risolte. Per informazioni su come risolvere questo problema, ignorare la sezione successiva relativa alla configurazione per VR e continuare con la sezione seguente, risoluzione delle impostazioni incompatibili.

Configurare il progetto per desktop VR tramite convalida del progetto (MR OpenXR 1.9+)

  1. Nella barra dei menu fare clic su Realtà mista > Impostazioni > di convalida progetto Win32 Application (Standalone) per abilitare le regole di convalida per un'app XR desktop.
  2. Nella finestra di convalida del progetto visualizzata, assicurarsi di essere nella scheda Piattaforma autonoma e fare clic su Correzione tutti per risolvere i problemi di convalida. Si noti che potrebbero verificarsi problemi che rimangono dopo aver fatto clic su Correzione di tutti. In questo caso, provare a fare clic su Correzione tutto , ignorare eventuali problemi contrassegnati come "specifici della scena" (se presente) e passare attraverso il resto dei problemi (se presenti) per verificare se sono presenti modifiche suggerite che si desidera apportare.

Configurare manualmente il progetto per desktop VR

  1. Assicurarsi che la finestra Impostazioni progetto sia aperta. In caso contrario, passare alla barra dei menu, selezionare Modifica>impostazioni progetto.

  2. Nella finestra Impostazioni progetto assicurarsi di essere nella pagina Gestione plug-in XR e nella scheda PC, Mac & Linux autonomo .

    Screenshot della finestra Impostazioni progetto aperta alla scheda Gestione plug-in XR e PC, Mac & Linux Standalone.

  3. Assicurarsi che inizializzare XR in Avvio sia selezionato e quindi, in Provider di plug-in, fare clic su OpenXR.

    Screenshot della finestra Impostazioni progetto, all'interno del PC, Mac & scheda Autonoma Linux, con Inizializza XR in Avvio selezionato e il plug-in OpenXR evidenziato.

  4. Il plug-in OpenXR viene caricato, quindi due elementi vengono visualizzati sotto OpenXR. Selezionare il primo gruppo di funzionalità Windows Mixed Reality.

    Screenshot della finestra Impostazioni progetto del plug-in OpenXR e Windows Mixed Reality gruppo di funzionalità evidenziato.

Si noti che ora viene visualizzato un triangolo di avviso giallo accanto a OpenXR. Ciò indica che sono presenti impostazioni incompatibili che devono essere risolte. Per informazioni su come risolvere questo problema, continuare alla sezione successiva, risoluzione delle impostazioni incompatibili.

Risoluzione delle impostazioni incompatibili

Importante

Le immagini di questa sezione mostrano le opzioni nella scheda piattaforma UWP (Universal Windows Platform). Tuttavia, le istruzioni sono uguali per la scheda Desktop VR, tranne dove indicato.

  1. Passare il cursore sul triangolo di avviso giallo accanto a OpenXR, quindi leggere il messaggio nel popup e quindi selezionare il triangolo.

    Screenshot dell'avviso relativo alla presenza di impostazioni non compatibili.

  2. Nella finestra di convalida del progetto OpenXR sono elencati diversi problemi. Selezionare il pulsante Correggi tutto. NOTA: questo elenco può essere diverso a seconda della scheda in cui si trova.

    Screenshot del pulsante Fix All nella finestra OpenXR Project Validation.

  3. Rimane un problema che indica che è necessario aggiungere almeno un profilo di interazione. A tale scopo, fare clic su Modifica. In questo modo si passa alle impostazioni per il plug-in OpenXR nella finestra di Impostazioni del progetto.

    Screenshot della finestra Project Settings con le impostazioni di OpenXR visualizzate.

  4. In Interaction Profiles si noti il pulsante più (+).

    Screenshot del pulsante di aggiunta di un profilo di interazione.

  5. Fare clic sul pulsante tre volte, scegliere ogni volta un profilo diverso:

    Eye Gaze Interaction Profile

    Microsoft Hand Interaction Profile

    Microsoft Motion Controller Profile

    Screenshot dei profili di interazione da aggiungere.

    Se accanto a Eye Gaze Interaction Profile o a qualsiasi altro profilo viene visualizzato un triangolo giallo, selezionarlo e successivamente nella finestra di convalida del progetto OpenXR fare clic sul pulsante Correggi. Al termine, chiudere la finestra di convalida del progetto OpenXR.

    Screenshot del pulsante Fix per il profilo di interazione Eye Gaze.

  6. Nella finestra Impostazioni del progetto di OpenXR Feature Groups verificare che siano selezionati gli elementi seguenti:

    Se si è nella scheda Desktop VR:

    Windows Mixed Reality

    Tracciamento della mano

    Motion Controller Model

    Screenshot del gruppo di funzionalità OpenXR per la scheda Desktop VR.

    Se si è nella scheda piattaforma UWP (Universal Windows Platform):

    Microsoft HoloLens

    Tracciamento della mano

    Motion Controller Model

    Screenshot delle funzionalità selezionate per OpenXR.

  7. Fare clic sull'elenco a discesa Depth Submission Mode e selezionare Depth 16 Bit.

    Screenshot dell'opzione Depth 16 Bit selezionata per Depth Submission Mode.

    Suggerimento

    La riduzione del formato di intensità a 16 bit è facoltativa, ma consente di migliorare le prestazioni grafiche nel progetto. Per altre informazioni, vedere Condivisione del buffer di intensità (HoloLens).

    Nota

    L'impostazione Modalità di rendering, che si trova appena sopra Depth Submission Mode, è impostata in modo predefinito su Single Pass Instanced. Nelle app di realtà mista il rendering della scena viene eseguito due volte, una per ogni occhio. Il risultato è una "visione stereoscopica". Ciò raddoppia la quantità di elaborazione necessaria, quindi è importante selezionare il percorso di rendering più efficiente in Unity per risparmiare tempo sia per la CPU e che per la GPU. Il rendering con istanza a passaggio singolo è la scelta migliore in questo caso. È consigliabile abilitarlo per impostazione predefinita per ogni progetto. Per altre informazioni, vedere la documentazione di Unity.

Configurare le impostazioni del lettore

  1. Nella colonna a sinistra della finestra Impostazioni del progetto selezionare Lettore.

  2. Si noti che nella finestra Lettore la casella Nome prodotto è già compilata. Questo nome viene ricavato dal nome del progetto e sarà il nome visualizzato nel menu Start di HoloLens.

    Screenshot di Publishing Settings per Unity con la casella del nome del progetto compilata.

    Suggerimento

    Per semplificare l'individuazione dell'app durante lo sviluppo, anteporre un carattere di sottolineatura al nome in modo che compaia all'inizio dell'elenco.

  3. Fare clic sull'elenco a discesa Impostazioni di pubblicazione e quindi nel campo Nome pacchetto immettere un nome appropriato.

    Screenshot di Publishing Settings per Unity con la casella del nome del pacchetto compilata.

    Nota

    Il nome del pacchetto è l'identificatore univoco dell'app. Se si vuole evitare di sovrascrivere le versioni installate in precedenza dell'app con lo stesso nome, è necessario modificare questo identificatore prima di distribuire l'app.

  4. Chiudere la finestra Project Settings (Impostazioni progetto).

A questo punto è possibile iniziare a sviluppare con OpenXR in Unity.

Progetti di esempio unity

Vedere il repository di esempi di OpenXR Realtà mista per i progetti unity di esempio che illustrano come compilare applicazioni Unity per HoloLens 2 o Realtà mista visori VR usando il plug-in OpenXR Realtà mista.

Vedi anche