Esercizio - Importare e configurare le risorse

Completato

Installare lo strumento per la funzionalità di Realtà mista

Per importare il Toolkit di Realtà Mista nel progetto, si userà lo Strumento per la funzionalità di realtà mista, che consente agli sviluppatori di individuare, aggiornare e importare i pacchetti di funzionalità. È 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 per la funzionalità di realtà mista dall'Area download Microsoft.

  2. Al termine del download, aprire il file MixedRealityFeatureTool.exe e usarlo per avviare lo strumento per la funzionalità Realtà mista.

    Nota

    Prima di poter eseguire lo Strumento per la funzionalità Realtà mista, potrebbe essere necessario installare il runtime di .NET 6.0.

Importare il pacchetto MRTK Unity Foundation

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

    Screenshot of the Mixed Reality Feature Tool opening screen.

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

    Screenshot of the Select Project screen.

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

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  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 gruppi di pacchetti disponibili.

    Screenshot of the main groups of packages in the Mixed Reality Feature Tool.

  5. Selezionare il pulsante + a sinistra di Platform Support (0 of 5), quindi selezionare la versione più recente di Mixed Reality OpenXR Plugin.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Selezionare il pulsante Seleziona tutto a destra di MRTK3 in modo che tutte le funzionalità siano selezionate.

    Screenshot of selecting all feature of MRTK3.

    Nota

    Se vengono visualizzati pacchetti contrassegnati come deprecati, è necessario rimuoverli e assicurarsi che l'opzione Impostazioni > Funzionalità > Mostra pacchetti deprecati sia deselezionata.

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

  8. Selezionare Convalidare per convalidare i pacchetti selezionati. Verrà visualizzata una finestra di dialogo che indica che non sono stati rilevati problemi di convalida. Una volta fatto, selezionare OK.

  9. Nella pagina Importa funzionalità la colonna a sinistra Funzionalità mostra i pacchetti appena selezionati. Nella colonna a destra Dipendenze obbligatorie mostra tutte le dipendenze. È possibile selezionare il 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. Selezionare Esci.

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

Configurare il progetto Unity

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

    Screenshot of Unity Restart Option.

  2. Unity chiederà di aggiornare i metodi in XR InteractionLayerMask, selezionare Ho effettuato un backup, procediamo! e attendere il riavvio di Unity.

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. Nella barra dei menu selezionare Realtà mista>Progetto>Applica impostazioni di progetto consigliate per HoloLens 2.

  4. Nella barra dei menu selezionare Modifica>Impostazioni progetto.... Selezionare Gestione plug-in XR. Assicurarsi che l'opzione Inizializza XR all'avvio sia selezionata e quindi in Provider plug-in, selezionare Open XR.

    Screenshot of Initialize XR on Startup.

  5. Il plug-in OpenXR viene caricato, quindi due elementi vengono visualizzati sotto OpenXR. Selezionare il primo, ovvero Microsoft HoloLens feature group. Selezionare il punto esclamativo giallo.

    Screenshot of Open XR option.

  6. Selezionare Correggi tutto.

    Screenshot of Fix All.

    Alcuni avvisi potrebbero rimanere. Ignorarli per il momento.

  7. Selezionare OpenXR in Gestione plug-in XR.

  8. In Profili di interazione, aggiungere Interazione manuale Microsoft e Profilo di interazione guardo fisso, se non già aggiunti.

    Screenshot of Add Interaction Profiles.

  9. Assicurarsi che Microsoft Hololens a sinistra sia selezionato e Tracciamento della mano, Funzionalità di realtà mista e Modello di controller di movimento a destra siano selezionati.

  10. Selezionare il segno di avviso accanto a Profilo di interazione sguardo fisso per ripristinare la finestra Convalida progetto. Assicurarsi di essere nella scheda Piattaforma UWP (la scheda mostra il logo di Windows) e quindi selezionare Correggi tutto per risolvere i problemi di convalida. Si noti che potrebbero verificarsi problemi che rimangono dopo aver selezionato Correggi tutto. In tal caso, selezionare di nuovo Correggi tutto, ignorare eventuali problemi contrassegnati come Specifici della scena e quindi leggere i consigli per i problemi rimanenti (se presenti) e apportare eventuali modifiche desiderate.

  11. In Impostazioni progetto selezionare MRTK3, quindi verificare se esiste un profilo valido. In caso contrario, cercare MRTKProfile in Pacchetti (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) del progetto e assegnarlo al profilo.

    Screenshot of MRTK profile.

Configurare le impostazioni del progetto

  1. Nella barra del menu selezionare Modifica>Impostazioni progetto.

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

  3. Si noti che nella finestra Lettore il nome del prodotto è "MRTK Tutorial". Questo nome proviene dal nome del progetto e sarà il nome visualizzato nel menu di avvio di HoloLens.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    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.

  4. Selezionare l'elenco a discesa Impostazioni di pubblicazione e quindi nel campo Nome pacchetto immettere un nome appropriato, ad esempio MRTK-Tutorials-Getting-Started:

    Screenshot of Unity Publishing Settings with the package name box filled in.

    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.

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

Creare la scena e configurare il Tooolkit di realtà mista

  1. Nella barra dei menu scegliere File>Nuova scena. Selezionare l'opzione Basic (predefinita) e quindi Crea.

  2. Nella finestra Progetto, passare alla cartella Pacchetti>Input MRTK>Asset>Prefab. Trascinare il prefab MRTK XR Rig nella gerarchia della scena.

    Screenshot of the adding MRTK XR Rig in the Inspector.

  3. Rimuovere l'oggetto gioco Main Camera perché l'oggetto gioco MRTK XR Rig contiene già una fotocamera.

    Screenshot of the Mixed Reality Toolkit in the Inspector.

  4. Aggiungere il prefab MRTK Input Simulator (Pacchetti>Input MRTK>Simulazione>Prefab) alla scena.

    Nota

    Questo passaggio è facoltativo, ma richiesto dalle simulazioni all'interno dell'editor.

    Screenshot of the input simulator.

  5. Nella barra dei menu scegliere File>Salva con nome....

  6. Passare alla cartella Assets>Scene, assegnare un nome al progetto e quindi salvarlo.