MRTK-csomagok – MRTK2

  • Cikk

A Mixed Reality Eszközkészlet (MRTK) olyan csomagok gyűjteménye, amelyek lehetővé teszik a platformfüggetlen Mixed Reality alkalmazásfejlesztést azáltal, hogy támogatást nyújtanak Mixed Reality hardverekhez és platformokhoz.

Az MRTK eszközcsomagként (.unitypackage) és a Unity Csomagkezelőn keresztül érhető el.

Eszközcsomagok

Az MRTK-objektum (.unitypackage) letölthető a GitHubról.

Az eszközcsomagok használatának néhány előnye:

  • A Unity 2018.4-hez és újabbhoz érhető el
  • Az MRTK egyszerű módosítása
    • Az MRTK az Eszközök mappában van

Íme néhány a kihívások közül:

  • Az MRTK a projekt Assets mappájának része, amely a következőhöz vezet:
    • Nagyobb projektek
    • Lassabb fordítási idők
  • Nincs függőségkezelés
    • Az ügyfeleknek manuálisan kell feloldaniuk a csomagfüggőségeket
  • Manuális frissítési folyamat
    • Több lépés
    • Nagyméretű (több mint 3000 fájl) verziókövetési frissítés
    • Az MRTK módosításainak elvesztésének kockázata
  • A példákat tartalmazó csomag importálása általában az összes példát tartalmazza

Az elérhető csomagok a következők:

Ezeket a csomagokat a Microsoft a GitHub forráskódjából bocsátja ki és támogatja.

Alapcsomag

A Mixed Reality Toolkit Foundation olyan kódkészlet, amely lehetővé teszi, hogy az alkalmazás közös funkciókat használjon Mixed Reality platformokon.

Pakage foundationMRTK Foundation Csomag

Az MRTK Foundation csomag a következőket tartalmazza.

Mappa Összetevő Leírás
MRTK/Core Interfész- és típusdefiníciók, alaposztályok, standard árnyékoló.
MRTK/Core/Providers Platformfüggetlen adatszolgáltatók
Kezét Alaposztály támogatása és szolgáltatások a kézkövetéshez.
InputAnimation Fejmozgás és kézkövetési adatok rögzítésének támogatása.
InputSimulation A kéz- és szembevitel szerkesztőben történő szimulációjának támogatása.
ObjectMeshObserver Térbeli tudatosságot figyelő, 3D-s modellt használ adatokként.
UnityInput A Unity bemeneti API-ján keresztül implementált gyakori bemeneti eszközök (joystick, egér stb.).
MRTK/Szolgáltatók Platformspecifikus adatszolgáltatók
LeapMotion Az UltraLeap Leap Motion vezérlő támogatása.
OpenVR OpenVR-eszközök támogatása.
Oculus Oculus-eszközök, például a Quest támogatása.
UnityAR (Kísérleti) Kamerabeállítás-szolgáltató, amely lehetővé teszi az MRTK használatát a mobil AR-eszközökkel.
WindowsMixedReality Támogatás Windows Mixed Reality eszközökhöz, beleértve a Microsoft HoloLens és a modern headseteket.
Windows Microsoft Windows-specifikus API-k, például beszédfelismerés és diktálás támogatása.
XR SDK (Kísérleti) A Unity új XR-keretrendszerének támogatása a Unity 2019.3-ban és újabb verziójában.
MRTK/SDK
Kísérleti Kísérleti funkciók, beleértve az árnyékolókat, a felhasználói felület vezérlőit és az egyes rendszerkezelőket.
Funkciók Az Foundation csomagra épülő funkciók.
Profilok A Microsoft Mixed Reality Toolkit rendszerek és szolgáltatások alapértelmezett profiljai.
StandardAssets Közös eszközök; modellek, anyagmintázatok, anyagok stb.
MRTK/SceneSystemResources A Jelenetrendszer által használt eszközök és erőforrások
MRTK/Szolgáltatások
BoundarySystem VR-határtámogatást megvalósító rendszer.
CameraSystem Kamerakonfigurációt és felügyeletet megvalósító rendszer.
DiagnosticsSystem Az alkalmazásdiagnosztikában implementáló rendszer, például egy vizuális profilkészítő.
InputSystem A felhasználói bevitel elérésének és kezelésének támogatását biztosító rendszer.
SceneSystem Többjelenetű alkalmazástámogatást biztosító rendszer.
SpatialAwarenessSystem A felhasználó környezetének tudatosítását támogató rendszer.
TeleportSystem A teleportálást támogató rendszer (az ugrások élményének mozgatása).
MRTK/StandardAssets MRTK Standard shader, basic materials and other standard assets for mixed reality experiences

Bővítménycsomag

A választható Microsoft.MixedRealityToolkit.Unity.Extensions csomag további szolgáltatásokat tartalmaz, amelyek kibővítik a Microsoft Mixed Reality Toolkit funkcióit.

Megjegyzés

A bővítménycsomaghoz Microsoft.MixedRealityToolkit.Unity.Foundation szükséges.

Mappa Összetevő Leírás
MRTK/bővítmények
HandPhysicsService Olyan szolgáltatás, amely fizikai támogatást ad a csuklós kezekhez.
LostTrackingService Szolgáltatás, amely leegyszerűsíti a Microsoft HoloLens eszközökön bekövetkező veszteség nyomon követését.
SceneTransitionService Szolgáltatás, amely leegyszerűsíti a zökkenőmentes jelenetáttűnések hozzáadását.

Eszközök csomag

Az opcionális Microsoft.MixedRealityToolkit.Unity.Tools csomag olyan hasznos eszközöket tartalmaz, amelyek javítják a vegyes valóság fejlesztési élményét a Microsoft Mixed Reality Toolkit használatával. Ezek az eszközök a Unity Szerkesztő Mixed Reality Toolkit > Utilities menüjében találhatók.

Megjegyzés

Az eszközcsomaghoz Microsoft.MixedRealityToolkit.Unity.Foundation szükséges.

Mappa Összetevő Leírás
MRTK/Eszközök
BuildWindow Az UWP-alkalmazások létrehozásának és üzembe helyezésének folyamatát leegyszerűsítő eszköz.
DependencyWindow Eszköz, amely függőségi diagramot hoz létre egy projektben lévő objektumokról.
ExtensionServiceCreator Varázsló, amely segítséget nyújt a bővítményszolgáltatások létrehozásához.
MigrationWindow Eszköz, amely segít az elavult MRTK-összetevőket használó kód frissítésében.
OptimizeWindow Segédprogram egy vegyes valóságú projekt konfigurálásának automatizálásához a Unityben a legjobb teljesítmény érdekében.
ReserializeAssetsUtility Támogatást nyújt adott Unity-fájlok újraszerializálásához.
RuntimeTools/Tools/ControllerMappingTool Segédprogram, amely lehetővé teszi a fejlesztők számára, hogy gyorsan meghatározzák a Unity-leképezéseket a hardvervezérlőkhöz.
ScreenshotUtility Lehetővé teszi az alkalmazásképek rögzítését a Unity-szerkesztőben.
TextureCombinerWindow Segédprogram a grafikus textúrák kombinálásához.
Eszköztár Felhasználói felület, amely megkönnyíti az MRTK UX-összetevők felderítését és használatát.

Segédprogramok tesztelése csomag

Az opcionális Microsoft.MixedRealityToolkit.TestUtilities csomag olyan segédszkriptek gyűjteménye, amelyek lehetővé teszik a fejlesztők számára a játékmód-tesztek egyszerű létrehozását. Ezek a segédprogramok különösen hasznosak az MRTK-összetevőket létrehozó fejlesztők számára.

Mappa Összetevő Leírás
MRTK/tesztek
TestUtilities A lejátszási módú tesztek létrehozásának egyszerűsítésére használható módszerek, beleértve a kézszimulációs segédprogramokat is.

Példák csomag

A példacsomag bemutatókat, példaszkripteket és mintajeleneteket tartalmaz, amelyek az alapcsomag funkcióit gyakorolják. Ez a csomag tartalmazza a HandInteractionExample jelenetet (az alábbi képen látható), amely mintaobjektumokat tartalmaz, amelyek különböző típusú (csuklós és nem artikulált) kézi bevitelre reagálnak.

HandInteractionExample jelenet

Ez a csomag szemkövetési bemutatókat is tartalmaz, amelyeket itt dokumentálunk

Általánosságban elmondható, hogy az MRTK minden új funkciójának tartalmaznia kell egy megfelelő példát a példacsomagban, nagyjából ugyanazt a mappastruktúrát és helyet követve.

Megjegyzés

A példacsomaghoz Microsoft.MixedRealityToolkit.Unity.Foundation szükséges.

Mappa Összetevő Leírás
MRTK/Példák
Demók Egyszerű jelenetek, amelyek egy vagy két kapcsolódó funkciót szemléltetnek.
Kísérleti A kísérleti funkciókat bemutató bemutató jelenetek.
StandardAssets Több bemutatójelenet által megosztott közös eszközök.

Unity Package Manager

A Unity 2019.4 és újabb verziójával létrehozott élményekért az MRTK a Unity Csomagkezelőn keresztül érhető el.

Az eszközcsomagok használatának néhány előnye:

  • Kisebb projektek
    • Tisztább Visual Studio-megoldások
    • Kevesebb beadandó fájl (az MRTK egy egyszerű hivatkozás a Packages/manifest.json fájlban)
  • Gyorsabb fordítás
    • A Unitynek nem kell újrafordítenie az MRTK-t az építés során
  • Függőségfeloldás
    • A szükséges MRTK-csomagok automatikusan települnek a függőségekkel rendelkező csomagok megadásakor
  • Egyszerű frissítés az új MRTK-verziókra
    • A fájl verziójának Packages/manifest.json módosítása

Íme néhány a kihívások közül:

  • Az MRTK nem módosítható
    • Nem lehet módosításokat végezni anélkül, hogy eltávolítanák őket a csomagfeloldás során
  • Az MRTK nem támogatja a Unity 2018.4-et tartalmazó UPM-csomagokat

Alapcsomag

Az alapcsomag (com.microsoft.mixedreality.toolkit.foundation) a Mixed Reality Toolkit alapja.

Mappa Összetevő Leírás
MRTK/Core Interfész- és típusdefiníciók, alaposztályok, standard shader.
MRTK/Core/Providers Platformfüggetlen adatszolgáltatók
Kezét Alaposztály-támogatás és szolgáltatások a kézkövetéshez.
InputAnimation A fejmozgatási és kézkövetési adatok rögzítésének támogatása.
InputSimulation A kéz- és szembevitel szerkesztőn belüli szimulációjának támogatása.
ObjectMeshObserver Térbeli tudatosságot figyelő, 3D-s modellt használ adatokként.
UnityInput A Unity bemeneti API-ján keresztül implementált gyakori bemeneti eszközök (joystick, egér stb.).
MRTK/Szolgáltatók Platformspecifikus adatszolgáltatók
LeapMotion Az UltraLeap Leap Motion vezérlő támogatása.
OpenVR OpenVR-eszközök támogatása.
Oculus Oculus-eszközök, például a Quest támogatása.
UnityAR (Kísérleti) Kamerabeállítás-szolgáltató, amely lehetővé teszi az MRTK használatát a mobil AR-eszközökkel.
WindowsMixedReality Támogatás Windows Mixed Reality eszközökhöz, beleértve a Microsoft HoloLens és a modern headseteket.
Windows Microsoft Windows-specifikus API-k, például beszédfelismerés és diktálás támogatása.
XR SDK (Kísérleti) A Unity új XR-keretrendszerének támogatása a Unity 2019.3-ban és újabb verziójában.
MRTK/SDK
Kísérleti Kísérleti funkciók, beleértve az árnyékolókat, a felhasználói felület vezérlőit és az egyes rendszerkezelőket.
Funkciók Az Foundation csomagra épülő funkciók.
Profilok A Microsoft Mixed Reality Toolkit rendszerek és szolgáltatások alapértelmezett profiljai.
StandardAssets Közös eszközök; modellek, anyagmintázatok, anyagok stb.
MRTK/Szolgáltatások
BoundarySystem VR-határtámogatást megvalósító rendszer.
CameraSystem Kamerakonfigurációt és felügyeletet megvalósító rendszer.
DiagnosticsSystem Az alkalmazásdiagnosztikában implementáló rendszer, például egy vizuális profilkészítő.
InputSystem A felhasználói bevitel elérésének és kezelésének támogatását biztosító rendszer.
SceneSystem Többjelenetű alkalmazástámogatást biztosító rendszer.
SpatialAwarenessSystem A felhasználó környezetének tudatosítását támogató rendszer.
TeleportSystem A teleportálást támogató rendszer (az ugrások élményének mozgatása).

Függőségek:

  • Standard eszközök (com.microsoft.mixedreality.toolkit.standardassets)

Standard eszközök

A standard assets csomag (com.microsoft.mixedreality.toolkit.standardassets) ) olyan összetevők gyűjteménye, amelyek minden vegyes valósági élményhez ajánlottak, beleértve a következőket:

  • MRTK Standard shader
  • Alapanyagok az MRTK Standard shaderrel
  • Hangfájlok
  • Betűtípusok
  • Textúrák
  • Ikonok

Megjegyzés

A szerelvénydefiníciókon alapuló kompatibilitástörő változások elkerülése érdekében az MRTK Standard shader egyes funkcióinak szabályozására használt szkriptek nem szerepelnek a standard adategység-csomagban. Ezek a szkriptek az alapcsomagban találhatók a MRTK/Core/Utilities/StandardShader mappában.

Függőségek: nincs

Bővítménycsomagok

Az opcionális bővítménycsomag (com.microsoft.mixedreality.toolkit.extensions) további összetevőket tartalmaz, amelyek kibővítik az MRTK funkcióit.

Mappa Összetevő Leírás
MRTK/bővítmények
HandPhysicsService Olyan szolgáltatás, amely fizikai támogatást ad a csuklós kezekhez.
LostTrackingService Szolgáltatás, amely leegyszerűsíti a veszteség nyomon követését Microsoft HoloLens eszközökön.
SceneTransitionService A zökkenőmentes jelenetáttűnéseket leegyszerűsítő szolgáltatás.
Minták~ Rejtett mappa (a Unity-szerkesztőben), amely tartalmazza a mintajeleneteket és -objektumokat.

A példaprojekteket tartalmazó csomagok használatának folyamatáról további információt a Mixed Reality Toolkit és Unity Package Manager című cikkben talál.

Függőségek:

  • Alaprendszer (com.microsoft.mixedreality.toolkit.foundation)

Eszközök csomag

A választható eszközök csomagja (com.microsoft.mixedreality.toolkit.tools) olyan eszközöket tartalmaz, amelyek hasznosak a vegyes valósági élmények létrehozásához. Ezek az eszközök általában szerkesztőösszetevők, és a kódjuk nem egy alkalmazás részeként jelenik meg.

Mappa Összetevő Leírás
MRTK/Eszközök
BuildWindow Az UWP-alkalmazások létrehozásának és üzembe helyezésének folyamatát leegyszerűsítő eszköz.
DependencyWindow Eszköz, amely egy projektben lévő objektumok függőségi gráfját hozza létre.
ExtensionServiceCreator Varázsló, amely segítséget nyújt a bővítményszolgáltatások létrehozásához.
MigrationWindow Az elavult MRTK-összetevőket használó kód frissítését segítő eszköz.
OptimizeWindow Segédprogram egy vegyes valósági projekt konfigurálásának automatizálásához a Unity legjobb teljesítménye érdekében.
ReserializeAssetsUtility Támogatást nyújt adott Unity-fájlok újraszerializálásához.
RuntimeTools/Tools/ControllerMappingTool Segédprogram, amely lehetővé teszi a fejlesztők számára, hogy gyorsan meghatározzák a Unity-leképezéseket a hardvervezérlőkhöz.
ScreenshotUtility Lehetővé teszi az alkalmazásképek rögzítését a Unity-szerkesztőben.
TextureCombinerWindow Segédprogram a grafikus textúrák kombinálásához.
Eszköztár Felhasználói felület, amely megkönnyíti az MRTK UX-összetevők felderítését és használatát.

Függőségek:

  • Alaprendszer (com.microsoft.mixedreality.toolkit.foundation)

Segédprogramok tesztelése csomag

Az opcionális teszteszközök csomag (com.microsoft.mixedreality.toolkit.testutilities) segédszkriptek gyűjteményét tartalmazza, amelyek lehetővé teszik a fejlesztők számára, hogy egyszerűen hozzanak létre lejátszási módú teszteket. Ezek a segédprogramok különösen hasznosak az MRTK-összetevőket létrehozó fejlesztők számára.

Mappa Összetevő Leírás
MRTK/tesztek
TestUtilities A lejátszási módú tesztek létrehozásának egyszerűsítésére használható módszerek, beleértve a kézszimulációs segédprogramokat is.

Függőségek:

  • Alapítvány (com.microsoft.mixedreality.toolkit.foundation)

Példák csomag

A példacsomag (com.microsoft.mixedreality.toolkit.examples) úgy van strukturálva, hogy a fejlesztők csak az érdekes példákat importálják.

A példaprojekteket tartalmazó csomagok használatának folyamatával kapcsolatos további részletek a Mixed Reality Toolkit és a Unity Package Manager című cikkben találhatók.

Mappa Összetevő Leírás
MRTK/Példák
Minták~ Rejtett mappa (a Unity-szerkesztőben), amely tartalmazza a mintajeleneteket és az objektumokat.
StandardAssets Több bemutatójelenet által megosztott közös eszközök.

Függőségek:

  • Alapítvány (com.microsoft.mixedreality.toolkit.foundation)
  • Bővítmények (com.microsoft.mixedreality.toolkit.extensions)

Lásd még