Uso dello strumento di funzionalità Realtà mista per installare gli strumenti di blocco del mondo

Strumento di funzionalità MR

Lo strumento Realtà mista funzionalità può essere un modo estremamente utile per ottenere gli strumenti di blocco mondiale, nonché altri pacchetti di Realtà mista preziosi per Unity.

Altre informazioni sullo strumento funzionalità MR sono disponibili nella relativa documentazione online, ma è estremamente facile da usare.

screenshot dello strumento di funzionalità Realtà mista

Installazione di WLT tramite lo strumento di funzionalità MR

Per ottenere la funzionalità WLT completa, selezionare semplicemente la versione più recente di "Strumenti di blocco mondiale" dallo strumento funzionalità MR. Procedere quindi all'aggiunta di WLT a una scena o alla guida introduttiva.

Se si ottengono gli esempi (che richiedono anche MRTK), non è necessario installare prima le dipendenze. È sufficiente selezionare il pacchetto Samples e verrà installato anche il set minimo di dipendenze necessarie. Ma vedere di seguito.

Nota

TL;Versione di ripristino di emergenza: se si installa dallo strumento funzionalità MR, è necessario installare in una cartella la cui lunghezza del percorso è lunga o minore di 11 caratteri, inclusa l'unità. Questo articolo è illustrato in dettaglio più dettagliato alla fine di questo articolo. Quindi e:\stuff\T1 funzionerà, ma e:\stuff\T12 non lo farà.

Esempi nello strumento funzionalità MR (pacchetti scrivibili)

Come accennato in precedenza, lo strumento di funzionalità MR e UPM installa i pacchetti come risorse di sola lettura. Per gli esempi, ciò è scomodo, perché gran parte del valore di campioni è in grado di fornire asset volatili che possono essere modificati per la sperimentazione.

Per abilitare questa operazione, gli esempi installati dallo strumento di funzionalità mr (o UPM) seguono un percorso leggermente diverso. L'installazione è un processo di due parti.

La prima parte procede esattamente come l'installazione dei pacchetti di sola lettura. Tuttavia, dopo tale installazione, gli esempi non verranno ancora visualizzati in Asset o pacchetti.

Per completare l'importazione degli esempi nel progetto:

  1. Aprire Unity Package Manager

  2. Se Gestione pacchetti è impostato su "Registro Unity", modificarlo in "In Project"

    Gestione pacchetti nel progetto

  3. Trovare gli esempi da completare l'installazione. Ecco come destinazione "Esempi di blocco mondiale v1.2.4".

    Pulsante Importa nel progetto

  4. Premere il pulsante "Importa nel progetto".

  5. Gli esempi verranno ora visualizzati in una cartella Samples in Asset, come illustrato qui. Possono essere spostati in base all'organizzazione del progetto.

    Esempi illustrati nel progetto Unity

Differenze tra i metodi di installazione

Esistono alcune considerazioni sottili quando si decide quale metodo di installazione usare.

Strumento funzionalità MR (pacchetti UPM)

Un driver principale per lo strumento funzionalità MR è dipendenze del pacchetto. Un pacchetto nello strumento funzionalità MR può specificare altri pacchetti che devono essere installati per funzionare correttamente. Lo strumento funzionalità può quindi acquisire e installare, non solo il pacchetto richiesto, ma anche tutte le relative dipendenze. Dopo aver elaborato l'installazione richiesta, non sono necessarie altre installazioni da tenere traccia.

La differenza più grande tra le risorse acquisite tramite lo strumento di funzionalità MR (o UPM) rispetto alle risorse acquisite dai file con estensione unitypackage, è che la prima viene installata solo in scrittura, mentre quest'ultima viene eliminata in proprio come le proprie risorse.

Si noti che quando si acquisisce WLT tramite lo strumento di funzionalità, la DLL del motore frozen world viene inserita come dipendenza. Non è necessaria alcuna installazione manuale tramite NuGet.

Versioni WLT (file con estensione unitypackage)

WLT pubblica le versioni periodiche, considerate snapshot molto stabili. Queste sono disponibili nella pagina Versioni degli strumenti di blocco mondiale .

Come accennato in precedenza, il risultato dell'importazione di questi file con estensione unitypackage nel progetto è uguale a se copiato nell'origine (vedere di seguito). Gli script e gli asset sono scrivibili e possono essere riorganizzati per adattarsi alla struttura.

La catena di dipendenze è molto semplice, ma è responsabilità del client di installazione (si) installare le dipendenze e il pacchetto desiderato.

Il grafo delle dipendenze semplice è lineare. Nell'elenco seguente ogni elemento dipende da ogni elemento sopra di esso, ma in nessun elemento seguente:

  1. DLL del motore mondiale congelato (da NuGet, vedere istruzioni di installazione)
  2. Motore core di blocco mondiale
  3. Strumenti di blocco mondiale
  4. Esempi di blocco mondiale (dipende anche da MRTK, ma MRTK è incluso in .unitypackage)

Dal codice GitHub (copia nell'origine)

Un'altra opzione per l'acquisizione di WLT consiste nell'ottenere l'origine direttamente da GitHub (tramite git o come zipfile) e copiarla nel progetto. Equivale all'installazione da .unitypackages precedente.

Per ottenere la corrispondenza dell'origine di una versione, trovare il ramo appropriato. Ad esempio, l'origine per la versione v1.2.4 si trova nel ramo release/v1.2.4.

Informazioni sul limite di lunghezza del percorso di installazione

Quando si installa da Realtà mista Strumento funzionalità

Windows impone una lunghezza massima del percorso di 260 caratteri. Il pacchetto Frozen World Engine ha alcuni percorsi interni molto lunghi. Lo strumento Realtà mista funzionalità (o UPM di Unity, a seconda di chi si vuole incolpare), aggiunge alcune stringhe molto lunghe al centro.

Si saprà se è stato superato il limite di MAX_PATH se vengono visualizzati errori nella console di Unity che si lamenta di non essere in grado di trovare parte di un percorso.

Errore percorso lungo

Anche in questo caso, il percorso e:\stuff\T1 di installazione funzionerà, ma e:\stuff\T12 sarà troppo lungo.

Ironicamente, il primo file da raggiungere il limite non è nemmeno usato in Windows, è per la compilazione iOS (iOS non ha il limite di MAX_PATH). WLT creerà ed eseguirà correttamente senza di esso. Tuttavia, l'esistenza del file interferisce con l'esecuzione di alcuni importanti script MRTK e probabilmente destabilizza Unity in altri modi sottili.

Quando si installano da file con estensione unitypackage o da github

Senza UPM/MRFeatureTool che inserisce i caratteri nei percorsi di installazione, c'è un po'più spazio di respirazione. Tuttavia, la gerarchia interna del percorso all'interno del motore Frozen World è ancora molto profonda. Quando si installano da file unitypackage o da github, la cartella di installazione deve essere di circa 100 caratteri lunghi o meno.

Ci sono altre indagini e discussioni in questo problema WLT.