A Mixed Reality funkcióeszköz használata a World Locking Tools telepítéséhez
Az MR funkció eszköz
A Mixed Reality funkció eszköz rendkívül hasznos módja lehet a World Locking Tools, valamint a Unity egyéb értékes Mixed Reality csomagjainak beszerzésének.
Az MR funkció eszközzel kapcsolatos további információk az online dokumentációban találhatók, de rendkívül könnyen használhatóak.
A WLT telepítése az MR funkcióeszközzel
A teljes WLT-funkció beszerzéséhez egyszerűen válassza ki a "World Locking Tools" legújabb verzióját az MR funkcióeszközből. Ezután adja hozzá a WLT-t egy jelenethez, vagy a rövid útmutatót.
Ha lekérte a mintákat (ami szintén MRTK-t igényel), nem szükséges először telepíteni a függőségeket. Egyszerűen válassza ki a Minták csomagot, és a szükséges függőségek minimális készlete is telepítve lesz. De lásd alább.
Megjegyzés
TL;DR-verzió – Ha az MR szolgáltatáseszközről telepíti, olyan mappába kell telepítenie, amelynek elérési útja legfeljebb 11 karakter hosszú, beleértve a meghajtót is. Ezt részletesebben a cikk végén ismertetik. Így e:\stuff\T1
fog működni, de e:\stuff\T12
nem fog.
Minták az MR funkcióeszközben (írható csomagok)
Ahogy fentebb említettük, az MR funkcióeszköz és a UPM csak olvasható erőforrásként telepíti a csomagokat. A minták esetében ez kényelmetlen, mivel a minták értékének nagy része olyan illékony eszközöket biztosít, amelyek kísérletezésre módosíthatók.
Ennek engedélyezéséhez az MR feature Tool (vagy UPM) által telepített minták kissé eltérő útvonalat követnek. A telepítésük két részből áll.
Az első rész ugyanúgy folytatódik, mint az írásvédett csomagok telepítése. A telepítés után azonban a minták még nem jelennek meg az Eszközök vagy a Csomagok nézetben.
A minták projektbe importálásának befejezése:
A Unity Csomagkezelő megnyitása
Ha a Csomagkezelő "Unity Registry" értékre van állítva, módosítsa a "Projektben" értékre
Keresse meg a telepítés befejezéséhez használni kívánt mintákat. Itt a "World Locking Samples 1.2.4-es verziót" célozzuk meg.
Nyomja le az "Importálás a projektbe" gombot.
A példák ekkor megjelennek az Eszközök mappa Minták mappájában, ahogy az itt látható. A projekt szervezetének megfelelően áthelyezhetők.
A telepítési módszerek közötti különbségek
A használandó telepítési módszer kiválasztásakor figyelembe kell venni néhány apró szempontot.
MR funkcióeszköz (UPM-csomagok)
Az MR funkció eszköz egyik fő illesztője a csomagfüggőségek. Az MR szolgáltatáseszközben lévő csomagok más csomagokat is megadhatnak, amelyeket telepíteni kell ahhoz, hogy megfelelően működjön. A funkcióeszköz így nemcsak a kért csomagot, hanem annak összes függőségét is beszerezheti és telepítheti. Miután a funkcióeszköz feldolgozta a kért telepítést, nem kell további telepítéseket nyomon követnie.
Az MR feature Tool (vagy UPM) használatával beszerzett erőforrások és a .unitypackage fájlokból beszerzett erőforrások közötti legnagyobb különbség az, hogy az előbbi csak írási módban van telepítve, míg az utóbbiak a saját erőforrásaihoz hasonlóan lesznek elvetve.
Vegye figyelembe, hogy a WLT szolgáltatáseszközön keresztüli beszerzésekor a rendszer függőségként hozza be a Frozen World Engine DLL-t. Nincs szükség manuális telepítésre a NuGet használatával.
WLT-kiadások (.unitypackage fájlok)
A WLT rendszeres kiadásokat tesz közzé, amelyek nagyon stabil pillanatképek. Ezek a World Locking Tools Releases (Világzárolási eszközök kiadásai) oldalon érhetők el.
Ahogy fentebb említettük, ezeknek a .unitypackage fájloknak a projektbe való importálásának eredménye megegyezik a forrásba másolt fájlokkal (lásd alább). A szkriptek és az objektumok írhatók, és a szerkezetnek megfelelően átrendezhetők.
A függőségi lánc nagyon egyszerű, de a telepítendő ügyfél (Ön) feladata a függőségek és a kívánt csomag telepítése.
Az egyszerű függőségi gráf lineáris. Az alábbi listában minden elem a fölötte lévő elemektől függ, de az alatta lévő elemektől nem:
- Frozen World Engine DLL (a NuGetből, lásd a telepítési utasításokat)
- World Locking Core Engine
- Világzárolási eszközök
- Világzárolási minták (az MRTK-tól is függ, de az MRTK a .unitypackage része)
GitHub-kódból (másolás a forrásban)
A WLT beszerzésének másik lehetősége, hogy közvetlenül a GitHubról szerzi be a forrást (giten vagy zipfile-ként), és másolja a projektbe. Ez egyenértékű a fenti .unitypackages telepítésével.
A kiadásnak megfelelő forrás lekéréséhez keresse meg a megfelelő ágat. Az 1.2.4-es kiadás forrása például a ágban release/v1.2.4
van.
Tudnivalók a telepítési útvonal hosszának korlátjáról
A Mixed Reality Feature Tool eszközről történő telepítéskor
A Windows legfeljebb 260 karakter hosszúságú elérési utat ír elő. A Frozen World Engine csomag nagyon hosszú belső útvonalakat. A Mixed Reality funkcióeszköz (vagy a Unity UPM-je, attól függően, hogy kiket szeretne hibáztatni) nagyon hosszú sztringeket ad hozzá középen.
Tudni fogja, hogy túllépte-e a MAX_PATH korlátot, ha hibaüzenetek jelennek meg a Unity-konzolon, amelyek arra panaszkodnak, hogy nem találja az elérési út egy részét.
A telepítési útvonal e:\stuff\T1
ismét működni fog, de e:\stuff\T12
túl hosszú lesz.
Ironikus módon a korlátot elérő első fájlt még a Windows sem használja, hanem az iOS-buildhez (az iOS nem rendelkezik a MAX_PATH korláttal). A WLT nélküle jól fog épülni és futni. A fájl megléte azonban megzavarja néhány fontos MRTK-szkript futtatását, és valószínűleg más finom módokon destabilizálja a Unityt.
A .unitypackage fájlokból vagy a GitHubról történő telepítéskor
Anélkül, hogy az UPM/MRFeatureTool karaktereket szúr be a telepítési útvonalakba, van egy kicsit több légzési hely. A fagyott világmotor belső elérésiút-hierarchiája azonban még mindig meglehetősen mély. A unitypackage-fájlokból vagy a GitHubról történő telepítéskor a telepítési mappa legfeljebb 100 karakter hosszúságú lehet.
Ebben a WLT-problémában több vizsgálat és vita is van.