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

Strumento funzionalità MR

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

Altre informazioni su MR Feature Tool sono disponibili nella documentazione online, ma è estremamente facile da usare.

Realtà mista screenshot dello strumento funzionalità

Installazione di WLT tramite lo strumento funzionalità MR

Per ottenere la funzionalità WLT completa, è sufficiente selezionare la versione più recente di "World Locking Tools" dallo strumento funzionalità MR. Passare 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 esegue l'installazione dallo strumento funzionalità MR, è necessario installare in una cartella la cui lunghezza del percorso è lunga o inferiore a 11 caratteri, inclusa l'unità. Questo argomento è illustrato in modo più dettagliato alla fine di questo articolo. Così 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 installano i pacchetti come risorse di sola lettura. Per i campioni, questo è scomodo, perché gran parte del valore dei campioni consiste nel 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 in due parti.

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

Per completare l'importazione degli esempi nel progetto:

  1. Aprire il Gestione pacchetti Unity

  2. Se il Gestione pacchetti è impostato su "Registro Unity", impostarlo su "In project"

    Gestione pacchetti in project

  3. Trovare gli esempi da completare l'installazione. Ecco come destinazione "World Locking Samples 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 Assets, come illustrato di seguito. Possono essere trasferiti in base all'organizzazione del progetto.

    Esempi illustrati nel progetto Unity

Differenze tra i metodi di installazione

Quando si decide quale metodo di installazione usare, è necessario tenere presenti alcune considerazioni minime.

Strumento funzionalità MR (pacchetti UPM)

Un driver principale per lo strumento funzionalità MR è le dipendenze del pacchetto. Un pacchetto nello strumento funzionalità MR può specificare altri pacchetti che devono essere installati affinché funzionino correttamente. Lo strumento funzionalità può quindi acquisire e installare, non solo il pacchetto richiesto, ma anche tutte le relative dipendenze. Dopo che lo strumento funzionalità ha elaborato l'installazione richiesta, non è necessario rilevare altre installazioni.

La differenza principale tra le risorse acquisite tramite lo strumento di funzionalità MR (o UPM) rispetto alle risorse acquisite dai file con estensione unitypackage è che il primo viene installato in sola scrittura, mentre quest'ultimo viene eliminato in modo analogo alle proprie risorse.

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

Versioni WLT (file con estensione unitypackage)

WLT pubblica versioni periodiche, considerate snapshot molto stabili. Questi sono disponibili nella pagina World Locking Tools Releases (Versioni degli strumenti di blocco globale).

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

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

Il semplice grafico delle dipendenze è lineare. Nell'elenco seguente ogni elemento dipende da ogni elemento sopra di esso, ma non da nessun elemento al di sotto di esso:

  1. DLL di Frozen World Engine (da NuGet, vedere le istruzioni di installazione)
  2. World Locking Core Engine
  3. Strumenti di blocco globale
  4. Esempi di blocco globale (dipende anche da MRTK, ma MRTK è incluso in .unitypackage)

Dal codice GitHub (copia nell'origine)

Un'altra opzione per acquisire WLT consiste nell'ottenere l'origine direttamente da GitHub (tramite Git o come file ZIP) e copiarla nel progetto. Equivale all'installazione dai pacchetti unity precedenti.

Per ottenere l'origine corrispondente a una versione, trovare il ramo appropriato. Ad esempio, l'origine per la versione 1.2.4 è nel ramo release/v1.2.4.

Informazioni sul limite di lunghezza del percorso di installazione

Durante l'installazione da Realtà mista Feature Tool

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

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

Errore di 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 per raggiungere il limite non viene neanche usato in Windows, è per la compilazione iOS (iOS non ha il limite di MAX_PATH). WLT compilerà 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 esegue l'installazione da file con estensione unitypackage o da GitHub

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

Ci sono altre indagini e discussioni in questo problema WLT.