Het Mixed Reality-functieprogramma gebruiken om World Locking Tools te installeren
Het MR-functieprogramma
De Mixed Reality Feature Tool kan een zeer handige manier zijn om de World Locking Tools te verkrijgen, evenals andere waardevolle Mixed Reality pakketten voor Unity.
Meer informatie over de MR-functietool vindt u in de online documentatie, maar het is zeer eenvoudig te gebruiken.
WLT installeren via mr-functiehulpprogramma
Als u de volledige WLT-functionaliteit wilt ophalen, selecteert u gewoon de nieuwste versie van 'World Locking Tools' uit de MR Feature Tool. Ga vervolgens verder met het toevoegen van WLT aan een scène of de snelstartgids.
Als u de voorbeelden ophaalt (waarvoor ook MRTK is vereist), is het niet nodig om eerst de afhankelijkheden te installeren. Selecteer het pakket Voorbeelden en de minimale set vereiste afhankelijkheden wordt ook geïnstalleerd. Maar zie hieronder.
Notitie
TL;DR-versie: als u installeert vanuit het MR-functieprogramma, moet u installeren in een map met een padlengte van 11 tekens of minder, inclusief het station. Dit wordt aan het einde van dit artikel uitgebreider uitgelegd. Dat e:\stuff\T1 werkt wel, maar e:\stuff\T12 niet.
Voorbeelden in het HULPPROGRAMMA VOOR MR-functies (beschrijfbare pakketten)
Zoals hierboven vermeld, installeren de MR Feature Tool en UPM pakketten als alleen-lezen resources. Voor steekproeven is dat onhandig, omdat een groot deel van de waarde van steekproeven ligt in het leveren van vluchtige activa die kunnen worden aangepast voor experimenten.
Om dit in te schakelen, volgen voorbeelden die zijn geïnstalleerd door het MR-functieprogramma (of UPM) een iets ander pad. Het installeren ervan is een tweedelig proces.
Het eerste deel gaat net als het installeren van de alleen-lezen pakketten. Na deze installatie worden de voorbeelden echter nog niet weergegeven in Activa of Pakketten.
Ga als volgende te werk om het importeren van de voorbeelden in uw project te voltooien:
Unity Package Manager openen
Als Package Manager is ingesteld op 'Unity Registry', wijzigt u dit in 'In Project'
Zoek de voorbeelden die u wilt installeren. Hier richten we ons op 'World Locking Samples v1.2.4'.
Klik op de knop Importeren in project.
De voorbeelden worden nu weergegeven onder de map Voorbeelden in Assets, zoals hier wordt weergegeven. Ze kunnen worden verplaatst naar gelang de organisatie van uw project.
Verschillen tussen installatiemethoden
Er zijn enkele subtiele overwegingen bij het bepalen van de installatiemethode die u wilt gebruiken.
MR Feature Tool (UPM-pakketten)
Een belangrijk stuurprogramma voor het MR-functieprogramma zijn pakketafhankelijkheden. Een pakket in het MR-functieprogramma kan andere pakketten opgeven die moeten worden geïnstalleerd om het goed te laten werken. Het functiehulpprogramma kan vervolgens niet alleen het pakket dat u aanvraagt, maar ook alle bijbehorende afhankelijkheden verkrijgen en installeren. Nadat het functiehulpprogramma de aangevraagde installatie heeft verwerkt, zijn er geen andere installaties die u hoeft op te sporen.
Het grootste verschil tussen resources die zijn verkregen via de MR Feature Tool (of UPM) en resources die zijn verkregen uit .unitypackage-bestanden, is dat de eerste zijn geïnstalleerd met alleen-schrijven, terwijl de laatste net als uw eigen resources worden verwijderd.
Houd er rekening mee dat bij het verkrijgen van WLT via het functiehulpprogramma, de Frozen World Engine DLL als een afhankelijkheid wordt binnengebracht. Handmatige installatie via NuGet is niet nodig.
WLT-releases (.unitypackage-bestanden)
WLT publiceert periodieke releases, die worden beschouwd als zeer stabiele momentopnamen. Deze zijn beschikbaar op de pagina World Locking Tools Releases .
Zoals hierboven vermeld, is het resultaat van het importeren van deze .unitypackage-bestanden in uw project hetzelfde als wanneer u in de bron hebt gekopieerd (zie hieronder). De scripts en assets kunnen worden geschreven en kunnen worden aangepast aan uw structuur.
De afhankelijkheidsketen is heel eenvoudig, maar het is de verantwoordelijkheid van de installerende client (u) om de afhankelijkheden en het gewenste pakket te installeren.
De eenvoudige afhankelijkheidsgrafiek is lineair. In de volgende lijst is elk item afhankelijk van elk item erboven, maar van geen item eronder:
- Frozen World Engine DLL (van NuGet, zie installatie-instructies)
- World Locking Core Engine
- Wereldvergrendelingshulpprogramma's
- World Locking Samples (ook afhankelijk van MRTK, maar MRTK is opgenomen in .unitypackage)
Vanuit GitHub-code (kopiëren in bron)
Een andere optie voor het verkrijgen van WLT is om de bron rechtstreeks op te halen uit GitHub (via git of als een zip-bestand) en deze naar uw project te kopiëren. Dit komt overeen met installeren vanuit de bovenstaande .unitypackages.
Als u de bron wilt ophalen die overeenkomt met een release, zoekt u de juiste vertakking. De bron voor release v1.2.4 bevindt zich bijvoorbeeld in vertakking release/v1.2.4.
Informatie over de lengtelimiet voor het installatiepad
Bij het installeren vanuit Mixed Reality functiehulpprogramma
In Windows wordt een maximale padlengte van 260 tekens opgelegd. Het Frozen World Engine-pakket heeft een aantal zeer lange interne paden. De Mixed Reality Feature Tool (of UNITY's UPM, afhankelijk van wie u de schuld wilt geven), voegt enkele zeer lange tekenreeksen in het midden toe.
U weet of u de limiet voor MAX_PATH hebt overschreden als u fouten ziet in de Unity-console waarin wordt geklaagd over het niet kunnen vinden van een deel van een pad.
Het installatiepad e:\stuff\T1 werkt wel, maar e:\stuff\T12 is te lang.
Ironisch genoeg wordt het eerste bestand dat de limiet bereikt niet eens gebruikt in Windows, maar voor de iOS-build (iOS heeft niet de MAX_PATH limiet). WLT wordt zonder dit probleem goed gebouwd en uitgevoerd. Het bestaan van het bestand zal echter de uitvoering van een aantal belangrijke MRTK-scripts verstoren en Unity waarschijnlijk op andere subtiele manieren stabiliseren.
Bij installatie vanuit .unitypackage-bestanden of vanuit GitHub
Zonder dat de UPM/MRFeatureTool tekens in de installatiepaden invoegt, is er iets meer ademruimte. De interne padhiërarchie binnen de Frozen World Engine is echter nog steeds erg diep. Wanneer u installeert vanuit unitypackage-bestanden of vanuit GitHub, moet de installatiemap ongeveer 100 tekens lang of minder zijn.
Er zijn meer onderzoeken en discussies in dit WLT-probleem.