Configurare un nuovo progetto OpenXR con MRTK

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

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

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

• Microsoft HoloLens

• Microsoft HoloLens 2

• Windows Mixed Reality auricolari

• Auricolari OpenVR (HTC Vive /Oculus Rift)

• Ultraleap Hand Tracking

• Dispositivi Android e iOS

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 XR di Windows 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 consente tale supporto.

XR legacy:

Se si usa ancora Unity 2019 o versioni precedenti, Microsoft consiglia di usare il supporto XR predefinito legacy.

Se si sta avviando 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.

   

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

   

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

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

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

   

7. Fare clic su Crea progetto. Verrà aperto il progetto in Unity.

   

Attenzione

Quando si lavora in Windows, esiste un limite MAX_PATH di 255 caratteri. Unity è interessato da questi limiti e potrebbe non essere compilato se un percorso di file è più lungo di 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 selezionareImpostazioni di compilazionefile>.

   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 gli auricolari immersive come HP Reverb G2. Questa è la scelta migliore se si sta creando per il HoloLens 2; tuttavia, se si sta puntando alla realtà virtuale desktop, è consigliabile usare il PC, Mac & piattaforma Autonoma Linux.

2. Eseguire una delle operazioni seguenti:

   Se si sta puntando a Desktop VR:

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

   

   Se si sta puntando al HoloLens 2:

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

   Tipo di compilazione: progetto D3D

   Versione dell'SDK di destinazione: versione più recente installata

   Versione minima della piattaforma: 10.0.10240.0

   Versione di Visual Studio: versione più recente installata

   

3. Fare clic sul pulsante Cambia piattaforma . Unity visualizza un indicatore di stato mentre cambia piattaforma.

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

Scaricare e installare lo strumento di funzionalità Realtà mista

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

1. Scaricare la versione più recente di Realtà mista Feature Tool dall'Area download Microsoft.

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

   

Importare i pacchetti Realtà mista Toolkit e OpenXR

1. Nel Realtà mista Strumento funzionalità selezionare Avvia.

   

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

   

   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 verifica che si tratti di una cartella di progetto Unity valida.

   

3. Selezionare Individua funzionalità.

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

4. Nella pagina Individua funzionalità si noti che è presente un elenco di sei gruppi di pacchetti.

   

5. Fare clic sul pulsante "+" a sinistra di Realtà mista Toolkit (0 di 10) e quindi selezionare la versione più recente di Realtà mista Toolkit Foundation.

   Nota

   Il pacchetto Realtà mista Toolkit Foundation è l'unico pacchetto che deve essere importato e configurato per usare MRTK con il progetto. Questo pacchetto include i componenti principali necessari per creare un'applicazione di realtà mista.

6. Fare clic sul pulsante "+" a sinistra di Supporto piattaforma (0 di 5) e quindi selezionare la versione più recente di Realtà mista plug-in OpenXR.

   

7. Dopo aver effettuato le selezioni, fare clic su Ottieni funzionalità.

8. Selezionare Convalida per convalidare i pacchetti selezionati. Verrà visualizzata una finestra di dialogo che indica che non sono stati rilevati problemi di convalida. Quando si esegue questa operazione, fare clic su OK.

9. Nella pagina Importa funzionalità , la colonna a sinistra Funzionalità visualizza i pacchetti appena selezionati. La colonna a destra, Required dependencies, visualizza tutte le dipendenze. È possibile fare clic sul collegamento Dettagli per uno di questi elementi per altre informazioni su di essi.

10. Quando si è pronti per procedere, selezionare Importa. Nella pagina Revisione e approvazione è possibile esaminare le informazioni sui pacchetti.

11. Selezionare Approva.

12. Tornare alla Editor Unity e fare clic su un'area vuota nell'interfaccia utente. Verrà visualizzata una barra di stato che mostra che i pacchetti vengono importati.

Configurare le impostazioni back-end di input

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

   

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

Se si sta sviluppando per la realtà virtuale desktop, ignorare questa sezione e passare a Configurare il progetto per la realtà virtuale desktop.

1. Sulla 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 precedenti alla versione 1.9, la voce di menu disponibile è Realtà mista > Le impostazioni di progetto consigliate per l'applicazione > del progetto sono consigliate per HoloLens 2.
2. Nella finestra di convalida del progetto visualizzata verificare di essere nella scheda piattaforma UWP (indicata dal logo di Windows) e fare clic su Correggi tutto per risolvere i problemi di convalida. Si noti che potrebbero verificarsi problemi che rimangono dopo aver fatto clic su Correggi tutto. In tal caso, provare a fare di nuovo clic su Correggi tutto , ignorare eventuali problemi contrassegnati come "specifici della scena" (se presenti) e esaminare il resto dei problemi (se presenti) per verificare se sono presenti modifiche suggerite che si desidera apportare.
3. Il progetto è quasi pronto per HoloLens 2 distribuzione a questo punto. Procedere con Configurare le impostazioni del lettore per il passaggio successivo.

Configurare manualmente il progetto per il HoloLens 2

Se si sta sviluppando per la realtà virtuale desktop, ignorare questa sezione e passare a Configurare il progetto per la realtà virtuale desktop.

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

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

   

3. Assicurarsi che l'opzione Inizializza XR all'avvio sia selezionata e quindi in Provider di plug-in fare clic su OpenXR.

   

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

   

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

Configurare il progetto per la realtà virtuale desktop tramite convalida del progetto (MR OpenXR 1.9+)

1. Sulla barra dei menu fare clic su Realtà mista > applicazione Win32 Application (Standalone) delle impostazioni > di convalida del progetto 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 Correggi tutto per risolvere i problemi di convalida. Si noti che potrebbero verificarsi problemi che rimangono dopo aver fatto clic su Correggi tutto. In tal caso, provare a fare di nuovo clic su Correggi tutto , ignorare eventuali problemi contrassegnati come "specifici della scena" (se presenti) e esaminare 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 verificare di essere nella pagina Gestione plug-in XR e nella scheda Pc, Mac & Linux Standalone .

   

3. Assicurarsi che l'opzione Inizializza XR all'avvio sia selezionata e quindi in Provider di plug-in fare clic su OpenXR.

   

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

   

Si noti che è ora 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, passare alla sezione successiva Risoluzione delle impostazioni incompatibili.

Risoluzione delle impostazioni incompatibili

Importante

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

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

   

2. Nella finestra Convalida progetto OpenXR sono elencati diversi problemi. Selezionare il pulsante Correggi tutto . NOTA: questo elenco può avere un aspetto diverso a seconda della scheda in cui ci si sta.

   

3. Rimane un problema e 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 Impostazioni progetto .

   

4. Sotto Profili di interazione prendere nota del pulsante segno più (+).

   

5. Fare clic sul pulsante tre volte, ogni volta che si sceglie un profilo diverso:

   Profilo di interazione sguardo fisso

   Profilo di interazione con Microsoft Hand

   Profilo controller di movimento Microsoft

   

   Se il profilo di interazione sguardo fisso o qualsiasi altro profilo viene visualizzato con un triangolo giallo accanto, selezionare il triangolo e quindi nella finestra Convalida progetto OpenXR fare clic sul pulsante Correggi . Al termine, chiudere la finestra Convalida progetto OpenXR .

   

6. Nella finestra Impostazioni progetto in Gruppi di funzionalità OpenXR verificare che siano selezionati gli elementi seguenti:

   Se si è nella scheda Desktop VR:

   Windows Mixed Reality

   Rilevamento della mano

   Modello di controller di movimento

   

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

   Microsoft HoloLens

   Rilevamento della mano

   Modello di controller di movimento

   

7. Fare clic sull'elenco a discesa Modalità invio profondità e quindi selezionare Profondità 16 Bit.

   

   Consiglio

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

   Nota

   L'impostazione Modalità di rendering , che si trova appena sopra la modalità di invio profondità, è impostata per impostazione predefinita su Single Pass Instanced. Nelle app di realtà mista viene eseguito il rendering della scena due volte: una per ogni occhio. Il risultato è "visione stereoscopica". Ciò raddoppia la quantità di elaborazione necessaria, quindi è importante selezionare il percorso di rendering più efficiente in Unity per risparmiare tempo sia sulla CPU che sulla 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 progetto selezionare Lettore.

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

   

   Consiglio

   Per semplificare l'individuazione dell'app durante lo sviluppo, aggiungere un carattere di sottolineatura davanti al nome per ordinarla all'inizio di qualsiasi elenco.

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

   

   Nota

   Il nome del pacchetto è l'identificatore univoco per l'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 Impostazioni progetto .

È ora possibile iniziare a sviluppare con OpenXR in Unity.

Progetti di esempio unity

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

Vedere anche

• Configurare un nuovo progetto OpenXR senza MRTK
• Aggiungere il plug-in OpenXR Realtà mista al progetto Unity esistente