Benvenuto nello strumento di funzionalità Realtà mista

Mixed Reality Feature Tool banner image

Importante

Lo strumento di funzionalità Realtà mista è disponibile solo per Unity al momento. Se si sta sviluppando in Unreal, vedere la documentazione relativa all'installazione degli strumenti .

Lo strumento di funzionalità Realtà mista è un nuovo modo per gli sviluppatori di individuare, aggiornare e aggiungere pacchetti di funzionalità Realtà mista nei progetti Unity. È possibile cercare i pacchetti in base al nome o alla categoria, visualizzarne le dipendenze e persino visualizzare le modifiche proposte al file manifesto del progetto prima dell'importazione. Se non si è mai usato un file manifesto prima, si tratta di un file JSON contenente tutti i pacchetti di progetti. Dopo aver convalidato i pacchetti desiderati, lo strumento per la funzionalità di realtà mista li scaricherà nel progetto di propria scelta.

Requisiti di sistema

Prima di poter eseguire lo strumento di funzionalità Realtà mista, è necessario:

Nota

Lo strumento di funzionalità Realtà mista attualmente viene eseguito solo in Windows.

Scarica

Dopo aver configurato l'ambiente:

Nota

Se non si ha familiarità con Unity Gestione pacchetti, seguire le istruzioni UPM.

Modifiche apportate a questa versione

La versione 1.0.2206.1-Preview include le correzioni seguenti:

  • Miglioramenti all'elaborazione dei feed
  • Registrazione aggiornata

Le funzionalità seguenti sono state aggiunte in questa versione:

  • I pacchetti a cui si fa riferimento nel manifesto del progetto possono ora essere ripristinati con un clic.

1. Guida introduttiva

Avviare lo strumento di funzionalità Realtà mista dal file eseguibile, che visualizza la pagina iniziale al primo avvio:

Getting started

Dalla pagina iniziale è possibile:

  • Configurare le impostazioni dello strumento usando il pulsante icona a forma di ingranaggio
  • Usare il pulsante punto interrogativo per avviare il Web browser predefinito e visualizzare la documentazione
  • Selezionare Avvia per iniziare a individuare i pacchetti di funzionalità

Nota

Se si usa la versione di anteprima pubblica MRTK3 nel progetto, è necessario abilitare Show preview releases nella Feature scheda delle impostazioni.

Recommended Feature Settings for MRTK3

2. Selezione del progetto Unity

Per assicurarsi che tutte le funzionalità individuate siano supportate nella versione del progetto di Unity, il passaggio fist consiste nel puntare lo strumento di funzionalità Realtà mista al progetto usando il pulsante con i puntini di sospensione (a destra del campo del percorso del progetto).

Select the Unity project

Nota

La finestra di dialogo visualizzata durante l'esplorazione per la cartella del progetto Unity contiene '_' come nome file. Deve essere presente un valore per il nome del file per abilitare la cartella da selezionare.

Quando si trova la cartella del progetto, fare clic sul pulsante Apri per tornare allo strumento di funzionalità Realtà mista.

Importante

Lo Strumento per la funzionalità di realtà mista esegue la convalida per assicurarsi che sia stato indirizzato a una cartella del progetto Unity. La cartella deve contenere Assetse PackagesProject Settings cartelle.

Dopo aver selezionato il progetto, è possibile

  • Funzionalità di ripristino: scaricare i pacchetti forniti dallo strumento funzionalità elencati nel manifesto del progetto in Pacchetti/MixedReality se non sono già presenti. La funzionalità è simile al nuget restore concetto. In genere è necessario eseguire questa operazione solo se si dispone di un progetto (con pacchetti di strumenti di funzionalità) clonato da un repository configurato per ignorare i file tarball. È possibile chiudere lo strumento di funzionalità dopo il ripristino se non è necessario ottenere nuovi pacchetti.

O

  • Individuare funzionalità: passare alla pagina successiva per selezionare i pacchetti che si desidera aggiungere al progetto.

3. Individuazione e acquisizione di pacchetti di funzionalità

Le funzionalità vengono raggruppate in base alla categoria per semplificare la ricerca. Ad esempio, la categoria Realtà mista Toolkit include diverse funzionalità da scegliere:

Discovery and acquisition

Quando lo strumento di funzionalità Realtà mista riconosce le funzionalità importate in precedenza, visualizza un messaggio di notifica per ogni funzionalità.

Notification of imported feature

Dopo aver fatto le scelte, selezionare Recupera funzionalità per scaricare tutti i pacchetti necessari dal catalogo. Per altre informazioni, vedere individuazione e acquisizione di funzionalità.

4. Importazione di pacchetti di funzionalità

Dopo l'acquisizione, viene presentato il set completo di pacchetti, insieme a un elenco di dipendenze necessarie. Se è necessario modificare le selezioni di funzionalità o pacchetti, questo è il momento:

Importing packages

È consigliabile usare il pulsante Convalida per assicurarsi che il progetto Unity possa importare correttamente le funzionalità selezionate. Dopo la convalida, verrà visualizzata una finestra di dialogo popup con un messaggio di esito positivo o un elenco di problemi identificati.

Selezionare Importa per continuare.

Nota

Dopo aver fatto clic sul pulsante Importa , se i problemi rimangono un messaggio semplice verrà visualizzato. Il consiglio è fare clic su No e usare il pulsante Convalida per visualizzare e risolvere i problemi.

Per altre informazioni, vedere Importazione di funzionalità.

5. Revisione e approvazione delle modifiche del progetto

Il passaggio finale sta esaminando e approvando le modifiche proposte ai file manifesto e di progetto:

  • Le modifiche proposte al manifesto vengono visualizzate a sinistra
  • I file da aggiungere al progetto sono elencati a destra
  • Il pulsante Confronta consente la visualizzazione affiancata del manifesto corrente e delle modifiche proposte

Authorization

Per altre informazioni, vedere Revisione e approvazione delle modifiche del progetto.

6. Project aggiornato

Quando le modifiche proposte vengono approvate, il progetto Unity di destinazione viene aggiornato per fare riferimento alle funzionalità di Realtà mista selezionate.

Project updated

La cartella Pacchetti del progetto Unity include ora una sottocartella MixedReality con i file del pacchetto di funzionalità e il manifesto conterrà i riferimenti appropriati.

Tornare a Unity, attendere il caricamento delle nuove funzionalità selezionate e avviare la compilazione.

Vedi anche