Esercizio - Importare e configurare le risorse

  • 10 minuti

Installare lo strumento per la funzionalità di Realtà mista

Per importare il toolkit di Realtà mista nel progetto, si userà lo strumento di Realtà mista funzionalità. Lo strumento consente agli sviluppatori di individuare, aggiornare e importare 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 eseguibile e usarlo per avviare lo strumento di Realtà mista funzionalità.

    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 (è il pulsante ... nell'immagine seguente), passare al progetto e aprirlo.

    Open your project

    Dopo aver selezionato una cartella, lo strumento verifica 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 Individua funzionalità notare che è presente un elenco di gruppi di pacchetti disponibili.

    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 e quindi Esci.

  12. 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 Sì.

    Screenshot of Unity Restart Option.

  2. Unity potrebbe chiedere informazioni sull'aggiornamento dei metodi in XR InteractionLayerMask. Selezionare il pulsante I Made a Backup, Go Ahead! e attendere il riavvio di Unity.

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. Sulla barra dei menu selezionare Modifica>Impostazioni progetto. Selezionare Gestione plug-in XR. Assicurarsi che l'opzione Inizializza XR all'avvio sia selezionata e quindi selezionare la casella di controllo Apri XR in Provider plug-in.

    Screenshot of Initialize XR on Startup.

  4. Il plug-in OpenXR viene caricato e due elementi vengono visualizzati in OpenXR. Selezionare la casella per il primo gruppo di funzionalità di Microsoft HoloLens. Selezionare il punto esclamativo giallo.

    Screenshot of Open XR option.

  5. Selezionare Correggi tutto.

    Screenshot of Fix All.

    Alcuni avvisi potrebbero rimanere. Ignorarli per il momento.

  6. Selezionare OpenXR in Gestione plug-in XR.

  7. In Profili di interazione selezionare +, quindi aggiungere profilo di interazione manuale Microsoft e profilo di interazione sguardo fisso, se non sono già stati aggiunti.

    Screenshot of Add Interaction Profiles.

  8. 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.

  9. Selezionare il punto esclamativo giallo accanto a Eye Gaze Interaction Profile (Profilo di interazione sguardo fisso) per tornare alla finestra Convalida progetto. Assicurarsi di essere nella scheda piattaforma UWP (nella scheda viene visualizzato il logo di Windows) e quindi selezionare Correggi tutto per risolvere i problemi di convalida. Si noti che alcuni problemi potrebbero rimanere. In tal caso, selezionare di nuovo Correggi tutto, ignorare eventuali problemi contrassegnati come Scene specifico e quindi leggere i consigli per i problemi rimanenti (se presenti) e apportare eventuali modifiche desiderate.

  10. Nella finestra Project Impostazioni selezionare MRTK3 e verificare se è presente un profilo valido. In caso contrario, cercare MRTKProfile nei pacchetti del progetto (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) e assegnarlo al profilo.

    Screenshot of MRTK profile.

Configurare le impostazioni del progetto

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

  2. Nella finestra Project Settings (Impostazioni progetto) selezionare Player (Riproduttore).

  3. Si noti che nella finestra Player il nome del prodotto è MRTK Tutorial. Questo è tratto dal nome del progetto e sarà il nome visualizzato nel menu Start 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 Pubblicazione Impostazioni, 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 (built-in) e quindi selezionare Crea.

  2. Nella finestra Project (Progetto) passare alla cartella Packages MRTK Input Assets Prefabs (Prefab>di>input>MRTK pacchetti). 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 Fotocamera, 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 selezionare File>Salva con nome.

  6. Passare alla cartella Assets Scenes (Scene asset),>quindi assegnare un nome e salvare il progetto.