Balíčky MRTK – MRTK2
Mixed Reality Toolkit (MRTK) je kolekce balíčků, které umožňují vývoj aplikací hybridní reality pro různé platformy tím, že poskytují podporu hardwaru a platforem hybridní reality.
MRTK je k dispozici jako balíčky prostředků (.unitypackage) a prostřednictvím Správce balíčků Unity.
Balíčky prostředků
Prostředek MRTK (.unitypackage) je možné stáhnout z GitHubu.
Mezi výhody používání balíčků prostředků patří:
- K dispozici pro Unity 2018.4 a novější
- Snadné provádění změn v MRTK
- MRTK je ve složce Assets
Příklady problémů, které je potřeba řešit:
- MRTK je součástí složky Assets projektu, což vede k
- Větší projekty
- Pomalejší časy kompilace
- Žádná správa závislostí
- Zákazníci musí vyřešit závislosti balíčků ručně.
- Ruční proces aktualizace
- Více kroků
- Velké aktualizace správy zdrojového kódu (3000+ soubor)
- Riziko ztráty změn provedených v MRTK
- Import balíčku příkladů obvykle znamená zahrnutí všech příkladů.
Dostupné balíčky jsou:
Tyto balíčky vydává a podporuje Microsoft ze zdrojového kódu na GitHubu.
Základní balíček
Mixed Reality Toolkit Foundation je sada kódu, která vaší aplikaci umožňuje využívat společné funkce napříč platformami hybridní reality.
Základní balíček MRTK
Základní balíček MRTK obsahuje následující:
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Core | Definice rozhraní a typů, základní třídy, standardní shader. | |
| MRTK/ Core/Providers | Poskytovatelé dat nezávislí na platformě | |
| Ruce | Podpora základní třídy a služby pro sledování rukou | |
| InputAnimation | Podpora záznamu pohybu hlavy a dat sledování rukou | |
| InputSimulation | Podpora simulace rukou a zraku v editoru | |
| ObjectMeshObserver | Pozorovatel prostorového povědomí s využitím 3D modelu jako dat | |
| UnityInput | Běžná vstupní zařízení (joystick, myš atd.) implementovaná prostřednictvím vstupního rozhraní API Unity. | |
| MRTK nebo poskytovatelé | Poskytovatelé dat specifických pro platformu | |
| LeapMotion | Podpora ovladače UltraLeap Leap Motion. | |
| OpenVR | Podpora zařízení OpenVR | |
| Oculus | Podpora zařízení Oculus, jako je Quest. | |
| UnityAR | (Experimentální) Poskytovatel nastavení fotoaparátu, který umožňuje použití MRTK s mobilními zařízeními AR. | |
| WindowsMixedReality | Podpora zařízení s Windows Mixed Reality, včetně Microsoft HoloLens a imerzivních náhlavních souprav. | |
| Windows | Podpora rozhraní API specifických pro Microsoft Windows, například řeč a diktování | |
| XR SDK | (Experimentální) Podpora nové architektury XR Unity v Unity 2019.3 a novějších verzích | |
| MRTK/SDK | ||
| Experimentální | Experimentální funkce, včetně shaderů, ovládacích prvků uživatelského rozhraní a jednotlivých správců systému | |
| Funkce | Funkce, které vycházejí ze základního balíčku. | |
| Profily | Výchozí profily pro systémy a služby Sady nástrojů Microsoft Mixed Reality. | |
| StandardAssets | Společné prostředky; modely, textury, materiály atd. | |
| MRTK/SceneSystemResources | Prostředky a prostředky používané systémem scén | |
| MRTK/Služby | ||
| BoundarySystem | Systém implementuje podporu hranic vr. | |
| CameraSystem | Systém implementuje konfiguraci a správu kamery. | |
| DiagnosticsSystem | Implementace systému v diagnostice aplikací, například v profileru vizuálu. | |
| InputSystem | Systém poskytuje podporu pro přístup k uživatelským vstupům a jejich zpracování. | |
| SceneSystem | Systém poskytující podporu více scénových aplikací. | |
| SpatialAwarenessSystem | Systém poskytuje podporu pro povědomí o prostředí uživatele. | |
| TeleportSystem | Systém poskytující podporu pro teleportování (pohybující se o zkušenostech ve skokech). | |
| MRTK/StandardAssets | STANDARDNÍ shader MRTK, základní materiály a další standardní prostředky pro prostředí hybridní reality |
Balíček rozšíření
Volitelný balíček Microsoft.MixedRealityToolkit.Unity.Extensions obsahuje další služby, které rozšiřují funkce sady nástrojů Microsoft Mixed Reality.
Poznámka:
Balíček rozšíření vyžaduje Microsoft.MixedRealityToolkit.Unity.Foundation.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK nebo rozšíření | ||
| HandPhysicsService | Služba, která přidává podporu fyziky pro kloubové ruce. | |
| LostTrackingService | Služba, která zjednodušuje zpracování ztráty sledování na zařízeních Microsoft HoloLens. | |
| SceneTransitionService | Služba, která zjednodušuje přidávání hladkých přechodů scén. |
Balíček nástrojů
Volitelný balíček Microsoft.MixedRealityToolkit.Unity.Tools obsahuje užitečné nástroje, které vylepšují vývojové prostředí hybridní reality pomocí sady nástrojů Microsoft Mixed Reality. Tyto nástroje se nacházejí v nabídce nástrojů Mixed Reality Toolkit > v Unity Editoru.
Poznámka:
Balíček nástrojů vyžaduje Microsoft.MixedRealityToolkit.Unity.Foundation.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Nástroje | ||
| BuildWindow | Nástroj, který pomáhá zjednodušit proces sestavování a nasazování aplikací pro UPW. | |
| DependencyWindow | Nástroj, který vytvoří graf závislostí prostředků v projektu. | |
| ExtensionServiceCreator | Průvodce, který vám pomůže při vytváření služeb rozšíření | |
| MigraceWindow | Nástroj, který pomáhá s aktualizací kódu, který používá zastaralé komponenty MRTK. | |
| OptimizeWindow | Nástroj, který pomáhá automatizovat konfiguraci projektu hybridní reality pro nejlepší výkon v Unity. | |
| ReserializeAssetsUtility | Poskytuje podporu pro změnu velikosti konkrétních souborů Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Nástroj, který vývojářům umožňuje rychle určit mapování Unity pro hardwarové řadiče. | |
| ScreenshotUtility | Umožňuje zachytávání imagí aplikací v editoru Unity. | |
| TextureCombinerWindow | Nástroj pro kombinování grafických textur. | |
| Panel nástrojů | Uživatelské rozhraní, které usnadňuje zjišťování a používání komponent uživatelského rozhraní MRTK. |
Testovací balíček nástrojů
Volitelný balíček Microsoft.MixedRealityToolkit.TestUtilities je kolekce pomocných skriptů, které vývojářům umožňují snadno vytvářet testy režimu přehrávání. Tyto nástroje jsou zvláště užitečné pro vývojáře vytvářející komponenty MRTK.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/testy | ||
| Testovací nástroje | Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro simulaci rukou |
Balíček příkladů
Balíček příkladů obsahuje ukázky, ukázkové skripty a ukázkové scény, které fungují v základním balíčku. Tento balíček obsahuje scénu HandInteractionExample (na obrázku níže), která obsahuje ukázkové objekty, které reagují na různé typy vstupu rukou (artikulované a nevyjadřované).
Tento balíček obsahuje také ukázky sledování očí, které jsou zde zdokumentované.
Obecně platí, že jakákoli nová funkce v MRTK by měla obsahovat odpovídající příklad v balíčku příkladů, zhruba za stejnou strukturou složek a umístěním.
Poznámka:
Balíček příkladů vyžaduje Microsoft.MixedRealityToolkit.Unity.Foundation.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/příklady | ||
| Ukázky | Jednoduché scény znázorňující jednu nebo dvě související funkce | |
| Experimentální | Ukázkové scény ilustrující experimentální funkce | |
| StandardAssets | Běžné prostředky sdílené několika ukázkovými scénami |
Správce balíčků Unity
Pro prostředí vytvořená pomocí Unity 2019.4 a novějších je MRTK k dispozici prostřednictvím Správce balíčků Unity.
Mezi výhody používání balíčků prostředků patří:
- Menší projekty
- Čistější řešení sady Visual Studio
- Méně souborů k vrácení se změnami (MRTK je jednoduchý odkaz v
Packages/manifest.jsonsouboru)
- Rychlejší kompilace
- Unity nemusí během sestavování znovu kompilovat MRTK.
- Řešení závislostí
- Požadované balíčky MRTK se instalují automaticky při zadávání balíčků se závislostmi.
- Snadná aktualizace na nové verze MRTK
- Změna verze v
Packages/manifest.jsonsouboru
- Změna verze v
Příklady problémů, které je potřeba řešit:
- MRTK je neměnný
- Během řešení balíčků nelze provádět změny, aniž by se odebraly.
- MRTK nepodporuje balíčky UPM s Unity 2018.4
Základní balíček
Základní balíček (com.microsoft.mixedreality.toolkit.foundation) tvoří základ sady nástrojů Mixed Reality.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Core | Definice rozhraní a typů, základní třídy, standardní shader. | |
| MRTK/ Core/Providers | Poskytovatelé dat nezávislí na platformě | |
| Ruce | Podpora základní třídy a služby pro sledování rukou | |
| InputAnimation | Podpora záznamu pohybu hlavy a dat sledování rukou | |
| InputSimulation | Podpora simulace rukou a zraku v editoru | |
| ObjectMeshObserver | Pozorovatel prostorového povědomí s využitím 3D modelu jako dat | |
| UnityInput | Běžná vstupní zařízení (joystick, myš atd.) implementovaná prostřednictvím vstupního rozhraní API Unity. | |
| MRTK nebo poskytovatelé | Poskytovatelé dat specifických pro platformu | |
| LeapMotion | Podpora ovladače UltraLeap Leap Motion. | |
| OpenVR | Podpora zařízení OpenVR | |
| Oculus | Podpora zařízení Oculus, jako je Quest. | |
| UnityAR | (Experimentální) Poskytovatel nastavení fotoaparátu, který umožňuje použití MRTK s mobilními zařízeními AR. | |
| WindowsMixedReality | Podpora zařízení s Windows Mixed Reality, včetně Microsoft HoloLens a imerzivních náhlavních souprav. | |
| Windows | Podpora rozhraní API specifických pro Microsoft Windows, například řeč a diktování | |
| XR SDK | (Experimentální) Podpora nové architektury XR Unity v Unity 2019.3 a novějších verzích | |
| MRTK/SDK | ||
| Experimentální | Experimentální funkce, včetně shaderů, ovládacích prvků uživatelského rozhraní a jednotlivých správců systému | |
| Funkce | Funkce, které vycházejí ze základního balíčku. | |
| Profily | Výchozí profily pro systémy a služby Sady nástrojů Microsoft Mixed Reality. | |
| StandardAssets | Společné prostředky; modely, textury, materiály atd. | |
| MRTK/Služby | ||
| BoundarySystem | Systém implementuje podporu hranic vr. | |
| CameraSystem | Systém implementuje konfiguraci a správu kamery. | |
| DiagnosticsSystem | Implementace systému v diagnostice aplikací, například v profileru vizuálu. | |
| InputSystem | Systém poskytuje podporu pro přístup k uživatelským vstupům a jejich zpracování. | |
| SceneSystem | Systém poskytující podporu více scénových aplikací. | |
| SpatialAwarenessSystem | Systém poskytuje podporu pro povědomí o prostředí uživatele. | |
| TeleportSystem | Systém poskytující podporu pro teleportování (pohybující se o zkušenostech ve skokech). |
Závislosti:
- Standardní prostředky (
com.microsoft.mixedreality.toolkit.standardassets)
Standardní prostředky
Standardní balíček prostředků (com.microsoft.mixedreality.toolkit.standardassets) je kolekce komponent, které se doporučují pro všechna prostředí hybridní reality, včetně:
- STANDARDNÍ shader MRTK
- Základní materiály pomocí shaderu MRTK Standard
- Zvukové soubory
- Písma
- Textury
- Ikony
Poznámka:
Aby nedocházelo k zásadním změnám založeným na definicích sestavení, skripty používané k řízení některých funkcí shaderu STANDARD MRTK nejsou součástí balíčku standardních prostředků. Tyto skripty najdete v základním balíčku ve MRTK/Core/Utilities/StandardShader složce.
Závislosti: žádná
Balíčky rozšíření
Volitelný balíček rozšíření (com.microsoft.mixedreality.toolkit.extensions) obsahuje další komponenty, které rozšiřují funkce MRTK.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK nebo rozšíření | ||
| HandPhysicsService | Služba, která přidává podporu fyziky pro kloubové ruce. | |
| LostTrackingService | Služba, která zjednodušuje předání ztráty sledování na zařízeních Microsoft HoloLens. | |
| SceneTransitionService | Služba, která zjednodušuje přidávání hladkých přechodů scén. | |
| Vzorky~ | Skrytá složka (v Unity Editoru), která obsahuje ukázkové scény a prostředky. |
Další podrobnosti o procesu použití balíčků obsahujících ukázkové projekty najdete v článku o sadě nástrojů Mixed Reality a Unity Správce balíčků.
Závislosti:
- Nadace (
com.microsoft.mixedreality.toolkit.foundation)
Balíček nástrojů
Volitelný balíček nástrojů (com.microsoft.mixedreality.toolkit.tools) obsahuje nástroje, které jsou užitečné pro vytváření prostředí hybridní reality. Obecně platí, že tyto nástroje jsou součástí editoru a jejich kód se nedoručuje jako součást aplikace.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Nástroje | ||
| BuildWindow | Nástroj, který pomáhá zjednodušit proces sestavování a nasazování aplikací pro UPW. | |
| DependencyWindow | Nástroj, který vytvoří graf závislostí prostředků v projektu. | |
| ExtensionServiceCreator | Průvodce, který vám pomůže při vytváření služeb rozšíření | |
| MigraceWindow | Nástroj, který pomáhá s aktualizací kódu, který používá zastaralé komponenty MRTK. | |
| OptimizeWindow | Nástroj, který pomáhá automatizovat konfiguraci projektu hybridní reality pro nejlepší výkon v Unity. | |
| ReserializeAssetsUtility | Poskytuje podporu pro změnu velikosti konkrétních souborů Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Nástroj, který vývojářům umožňuje rychle určit mapování Unity pro hardwarové řadiče. | |
| ScreenshotUtility | Umožňuje zachytávání imagí aplikací v editoru Unity. | |
| TextureCombinerWindow | Nástroj pro kombinování grafických textur. | |
| Panel nástrojů | Uživatelské rozhraní, které usnadňuje zjišťování a používání komponent uživatelského rozhraní MRTK. |
Závislosti:
- Nadace (
com.microsoft.mixedreality.toolkit.foundation)
Testovací balíček nástrojů
Volitelný balíček nástrojů pro testování (com.microsoft.mixedreality.toolkit.testutilities) obsahuje kolekci pomocných skriptů, které vývojářům umožňují snadno vytvářet testy režimu přehrávání. Tyto nástroje jsou zvláště užitečné pro vývojáře vytvářející komponenty MRTK.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/testy | ||
| Testovací nástroje | Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro simulaci rukou |
Závislosti:
- Nadace (
com.microsoft.mixedreality.toolkit.foundation)
Balíček příkladů
Balíček příkladů (com.microsoft.mixedreality.toolkit.examples) je strukturovaný tak, aby vývojářům umožňoval importovat pouze příklady zájmu.
Další podrobnosti o procesu použití balíčků obsahujících ukázkové projekty najdete v článku o sadě nástrojů Mixed Reality a Unity Správce balíčků.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/příklady | ||
| Vzorky~ | Skrytá složka (v Unity Editoru), která obsahuje ukázkové scény a prostředky. | |
| StandardAssets | Běžné prostředky sdílené několika ukázkovými scénami |
Závislosti:
- Nadace (
com.microsoft.mixedreality.toolkit.foundation) - Rozšíření (
com.microsoft.mixedreality.toolkit.extensions)