Eszközök és vizualizációk

A Microsoft.MixedReality.WorldLocking.Tools névtér eszközei és vizualizációi a fejlesztés során nyújtanak segítséget. A WLT(World Locking Tools) rendszerrel való speciális közvetlen interakció kiindulópontja is lehet.

Bár nem közvetlen használatra szánták őket, mint egy alkalmazáson belül, az alkalmazás fejlesztője szabadon dönthet úgy, hogy ezt megteszi.

A WorldLocking.Core bármilyen megfelelő alkalmazási forgatókönyvben használható. Az eszközök azonban feltételezéseket tehetnek az alkalmazásról. Ezek a feltételezések bizonyos helyzetekben helytelenek lehetnek.

Mielőtt bármelyik eszközt közvetlenül a szállítási alkalmazásba beépítené, érdemes lehet létrehoznia az eszköz saját igényeinek és erőforrásainak megfelelően testre szabott verzióját.

Eszközök

Igazítók

A beállítók olyan összetevők, amelyek kezelik az újraszerelő eseményeket. Különösen mellékletpontokat hoznak létre. Újra-méretezési művelet esetén az AttachmentPoint értesítési visszahívásként szolgál. Az Igazító megfelelően kezeli az eseményt.

Tekintse meg a AttachmentPoints további fogalmi ismertetését.

Az újrafelszerelt esemény pontos helyes reakciója különböző típusú objektumok esetén eltérő, és nagyon alkalmazásspecifikus. Ha például az objektum töredéke jelenleg inaktív, akkor meg kell jelennie az objektumnak? Egyes alkalmazások esetében, mivel az objektum megfelelő elhelyezése nem határozható meg, rejtve kell lennie. Más alkalmazások esetében jobb lehet az objektumot ideiglenesen helytelen pózban megjeleníteni, mint az eltűnésének zavarát. És még az olyan alkalmazások esetében is, amelyeknek el kell rejtenie az objektumot, különböző módokon hajthatja végre a elrejtést (például letiltás vagy távolodás).

Az AdjusterFixed és az AdjusterMoving összetevők minimálisan két gyakori forgatókönyvet kezelnek.

Az AdjusterFixed összetevő feltételezi, hogy a cél általában nem mozog. Ha a World Locking Tools egy refit esemény miatt korrekciós pózt küld, az Az Igazítófixed objektumának helyhez kötöttnek kell maradnia a világon.

Ezzel szemben az IgazítóMoving összetevő feltételezi, hogy a cél a Unity koordináta-térben való mozgatása. A World Locking Tools rendszerét a célhelyre értékelve tartja, hogy egy újrafelszerelt művelet esetén a rendszer a lehető legpontosabb korrekciót nyújthassa, hogy a cél pozíciója a fizikai világ állandójához viszonyítva maradjon abban a pillanatban.

Adapterek

Az adapter összetevői csak illusztrációra szolgálnak. Ha az egyik adaptert használja, érdemes újragondolnia, hogyan próbálja használni a World Locking Toolst.

Az MRTK már rendelkezik beépített adapterekkel, így az alkalmazás nem igényel további koordinátarendszer-átalakítást.

Előfordulhatnak olyan időszakok, különösen, ha nem használja az MRTK-t, amikor a natív erőforrásokról való átalakítás, amely a Spongy Space koordinátáiban fog jelentést tenni, a fagyott térre. Ezekben az esetekben az alkalmazásfejlesztő az itt található adapterek egyikét találhatja jó referenciaként.

• WorldAnchorAdapter - A WorldAnchor beállítja egy objektum pózát a Spongy térben, hogy a fizikai térben rögzített maradjon. Ez redundáns a World Locking Tools által biztosított világzárolási tér miatt, így az objektum a fagyott térben sodródik. Ez az adapter lehetővé teszi a WorldAnchor számára, hogy fenntartsa egy objektum pózát a Frozen Space-ben. Ez a diagnosztika kivételével szükségtelen. A Unity globális koordináta-területén található összes objektumot a World Locking Tools zárolja.

• ToggleWorldAnchor - Hasonló a WorldAnchorAdapterhez, de kapcsolható. Emellett automatikusan normál WorldAnchor-viselkedésre vált, ha a WorldLockingManager le van tiltva. Csak diagnosztikához hasznos.

• FrozenSpatialMapping – Az adapterek kezelik és megfelelően renderelik az eredményeket egy SurfaceObserverből. Az MRTK térbeli tudatossági rendszere mindezeket a funkciókat és egyebeket biztosítja, és nem igényel adaptert a World Locking Tools használatához.

• FrozenTapToAdd – A Unity bemeneti rendszerével való közvetlen együttműködéshez a bejövő koordináta-adatok konvertálása szükséges az itt látható módon. Ez szükségtelen az MRTK bemeneti rendszerével.

Visualizers

Horgonydiagram-vizualizáció

Az AnchorGraphVisual és a hozzá tartozó előfab a megadott vizualizációk magja. Az összetevők a következők:

1. Tengelyek – A Spongy Space (zöld) és a Frozen Space (kék) eredetének aktuális pózai standard 3 nyíltengely-azonosítóként jelennek meg.

2. Spongy Anchors - Ezek a natív mögöttes horgonyok, amelyeket azért hoztak létre, hogy táplálja a Frozen World Engine optimalizálás. Mindegyiket egy gyűrű, valamint egy azonosító szövegcímke jelöli. Emellett további információkat is közvetít a szín és a méret.

   • Az aktív nyomon követett horgony zöld színű lesz.

   • A nulla relevanciával rendelkező nyomon követett horgony piros lesz.

   • A nem támogatott horgony sárga lesz.

   • Minél nagyobb a gyűrű, annál nagyobb a horgony relevanciája.

3. Fagyasztott horgonyok – Ezek a megfelelő referenciapontok a Frozen Space-ben. Nyomkövető hiba hiányában ezek pontosan igazodnak a spongy horgonyokhoz.

4. Spongy-Frozen Edges - Ezek összekapcsolják a spongy horgonyok a megfelelő fagyasztott horgonyok. Mivel a nyomkövető hibája hiányában ezek egybeesnek, a élek nem láthatók, azt jelenti, hogy minden tökéletesen működik. Mindenesetre ezek a élek nem lehetnek hosszabbak néhány centiméternél. Pirosak a befagyott végen. A szín kékre halványul a spongy végén.

5. Horgonyszegélyek – Ezek a vékony kék-szürke vonalak a horgonydiagramon a spongy horgonyok közötti kapcsolatokat mutatják.

A World Locking Tools által a fizikai környezetről való mozgás során létrehozott horgonydiagram megjelenítésének engedélyezéséhez csak a WorldLockingTools > Prefabs > AnchorGraphVisual előfabját kell a jelenetbe dobni. Ez szokás szerint testvérként van hozzáadva a WorldLockingContexthez, de pontos elhelyezése a hierarchiában nem lényeges. Ezt azonban nem szabad a kamerahierarchiába helyezni.

A WLT által belsőleg létrehozott és használt térbeli horgonyok a kamera helyzetében jönnek létre. Mivel nyugtalanító, hogy a horgonyvizualizációk egyik mezőjén kell végigmenni szemmagasságban, a rendszer alapértelmezés szerint 1 méterre jelenik meg a valódi helyzetüktől. A horgonyvizualizációk tényleges horgonyhelyzetekben való megtekintéséhez állítsa a Horgonydiagram vizualizáció összetevő függőleges elmozdulási paraméterét nullára.

További kimenet

A világzárolási példák szövegdiagnosztikát is tartalmaznak. Ezek többsége csak a World Locking Tools fejlesztői számára releváns, nem pedig a képességeinek ügyfelei számára. Ezek azonban olvashatók, és a StatusToText szkriptben látható módon valós idejű megjelenítésre is elérhetők.

A halál utáni elemzéshez a WorldLockingContext Diagnosztikai szakasza nagyon hasznos lehet a fagyasztott világmotor hibáinak jelentésében. További információkért tekintse meg a hibajelentést .