Benvenuto nello strumento di funzionalità Realtà mista
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:
- Un PC che esegue Windows 10 o 11 con una connessione Internet attiva
Nota
Se il PC si trova in una rete gestita da un'organizzazione, assicurarsi che l'accesso agli URL seguenti sia consentito:
- https://aka.ms/*
- https://learn.microsoft.com/*
- https://pkgs.dev.azure.com/*
- https://feeds.dev.azure.com/*
- https://mixedrealitycloud.pkgs.visualstudio.com/* (solo per utenti di accesso anticipato speciale)
Scarica
Dopo aver configurato l'ambiente:
- Scaricare la versione più recente dello strumento di funzionalità Realtà mista dall'Area download Microsoft.
- Al termine del download, decomprimere il file e salvarlo nel desktop
- È consigliabile creare un collegamento al file eseguibile per un accesso più veloce
Nota
Se non si ha familiarità con Unity Package Manager, seguire le istruzioni UPM.
Modifiche apportate a questa versione
La versione 1.0.2209.0-Preview include i miglioramenti seguenti:
- Aggiunta dell'opzione 'show preview features' (Mostra funzionalità di anteprima) alla visualizzazione delle funzionalità di individuazione
- Aggiornato a .NET 6
- Consolidare l'app e il runtime .NET 6 in un singolo eseguibile per semplificare la distribuzione
- È stato risolto un problema a causa del quale viene visualizzata una richiesta di downgrading delle versioni del pacchetto esistenti quando non è necessario
1. Guida introduttiva
Avviare lo strumento di funzionalità Realtà mista dal file eseguibile, che visualizza la pagina iniziale al primo avvio:
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à
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).
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 restoreconcetto. 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:
Nota
Se si usa la versione di anteprima pubblica MRTK3 nel progetto, è necessario abilitare Show preview releases come illustrato di seguito nella casella rossa.
Quando lo strumento di funzionalità Realtà mista riconosce le funzionalità importate in precedenza, visualizza un messaggio di notifica per ogni funzionalità.
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:
È 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 semplice messaggio 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
Per altre informazioni, vedere Revisione e approvazione delle modifiche del progetto.
6. Progetto aggiornato
Quando le modifiche proposte vengono approvate, il progetto Unity di destinazione viene aggiornato per fare riferimento alle funzionalità di Realtà mista selezionate.
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.