Balíčky MRTK – MRTK2
Mixed Reality Toolkit (MRTK) je kolekce balíčků, které umožňují vývoj aplikací pro různé platformy Mixed Reality poskytováním podpory pro hardware a platformy Mixed Reality.
MRTK je k dispozici jako balíčky prostředků (.unitypackage) a prostřednictvím Správce balíčků Unity.
Balíčky prostředků
Asset 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 MRTK
- MRTK je ve složce Prostředky.
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 (více než 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:
Microsoft tyto balíčky vydává a podporuje je 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 běžné funkce napříč platformami Mixed Reality.
MRTK Foundation Package
Balíček MRTK Foundation obsahuje následující:
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Core | Definice rozhraní a typů, základní třídy, standardní shader. | |
| MRTK/ jádro / poskytovatelé | Poskytovatelé dat nezávislí na platformě | |
| Ruce | Podpora základní třídy a služby pro sledování rukou | |
| InputAnimation | Podpora pro zaznamenávání údajů o pohybu hlavy a sledování rukou. | |
| InputSimulation | Podpora simulace vstupu rukou a zraku v editoru | |
| ObjectMeshObserver | Pozorovatel prostorového povědomí, který jako data používá 3D model. | |
| UnityInput | Běžná vstupní zařízení (pákový ovladač, myš atd.) implementovaná prostřednictvím vstupního rozhraní API Unity. | |
| MRTK/ Poskytovatelé | Poskytovatelé dat pro konkrétní platformu | |
| LeapMotion | Podpora ovladače přestupového pohybu UltraLeap. | |
| OpenVR | Podpora zařízení s OpenVR | |
| Oculus | Podpora zařízení Oculus, jako je například úkol. | |
| UnityAR | (Experimentální) Poskytovatel nastavení kamery, který umožňuje použití MRTK s mobilními zařízeními s rozšířenou realitou. | |
| WindowsMixedReality | Podpora Windows Mixed Reality zařízení, včetně Microsoft HoloLens a imerzivních náhlavních souprav. | |
| Windows | Podpora rozhraní API specifických pro Microsoft Windows, například pro řeč a diktování. | |
| XR SDK | (Experimentální) Podpora nové architektury XR unity v Unity 2019.3 a novější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á staví na základním balíčku. | |
| Profily | Výchozí profily pro systémy a služby Microsoft Mixed Reality Toolkit. | |
| Standardníassets | 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. | |
| Systém diagnostiky | Implementace systému v diagnostice aplikací, například vizuální profilátor. | |
| InputSystem | Systém poskytující podporu přístupu a zpracování uživatelských vstupů. | |
| SceneSystem | Systém poskytující podporu aplikací s více scény. | |
| SpatialAwarenessSystem | Systém poskytující podporu pro povědomí o prostředí uživatele. | |
| TeleportSystem | Systém poskytující podporu pro teleportování (pohyb o zkušenostech ve skokech). | |
| MRTK/StandardAssets | MRTK Standardní shader, 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 Microsoft Mixed Reality Toolkit.
Poznámka
Balíček rozšíření vyžaduje Microsoft.MixedRealityToolkit.Unity.Foundation.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK / Rozšíření | ||
| HandPhysicsService | Služba, která přidává podporu fyziky do kloubových rukou. | |
| LostTrackingService | Služba, která zjednodušuje zpracování ztráty sledování u Microsoft HoloLens zařízení. | |
| 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í prostředí pro vývoj pro hybridní realitu pomocí sady Microsoft Mixed Reality Toolkit. Tyto nástroje se nacházejí v nabídce nástroje 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 vytváření 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 s vytvářením služeb rozšíření | |
| MigraceWindow | Nástroj, který pomáhá s aktualizací kódu, který používá zastaralé komponenty MRTK. | |
| OptimizeWindow | Nástroj, který vám pomůže automatizovat konfiguraci projektu hybridní reality pro zajištění nejlepšího výkonu v Unity | |
| ReserializeAssetsUtility | Poskytuje podporu pro změnu velikosti konkrétních souborů Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Nástroj umožňující vývojářům rychle určit mapování Unity pro hardwarové kontrolery | |
| ScreenshotUtility | Umožňuje zachytávání imagí aplikací v editoru Unity. | |
| TextureCombinerWindow | Nástroj pro kombinování grafických textur. | |
| Sada nástrojů | Uživatelské rozhraní, které usnadňuje zjišťování a používání komponent uživatelského prostředí 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ášť užitečné pro vývojáře vytvářející komponenty MRTK.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Testy | ||
| TestUtilities | Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro ruční simulaci |
Balíček příkladů
Balíček příkladů obsahuje ukázky, ukázkové skripty a ukázkové scény, které procvičují funkce 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é i nevyformulované).
Tento balíček obsahuje také ukázky sledování očí, které jsou popsány zde.
Obecněji platí, že každá nová funkce v MRTK by měla v balíčku examples obsahovat odpovídající příklad, který zhruba odpovídá stejné struktuře a umístění složek.
Poznámka
Balíček příkladů vyžaduje Microsoft.MixedRealityToolkit.Unity.Foundation.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Příklady | ||
| Dema | Jednoduché scény znázorňující jednu nebo dvě související funkce | |
| Experimentální | Ukázkové scény ilustrující experimentální funkce | |
| Standardníassets | Společné prostředky sdílené několika ukázkovými scénami. |
Správce balíčků Unity
Pro prostředí vytvář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ů ke 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ý
- Při řešení balíčku nejde provést změny, pokud se neodeberou.
- 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/ jádro / poskytovatelé | Poskytovatelé dat nezávislí na platformě | |
| Ruce | Podpora základní třídy a služby pro sledování rukou | |
| InputAnimation | Podpora pro zaznamenávání údajů o pohybu hlavy a sledování rukou. | |
| InputSimulation | Podpora simulace vstupu rukou a zraku v editoru | |
| ObjectMeshObserver | Pozorovatel prostorového povědomí, který jako data používá 3D model. | |
| UnityInput | Běžná vstupní zařízení (pákový ovladač, myš atd.) implementovaná prostřednictvím vstupního rozhraní API Unity. | |
| MRTK/ Poskytovatelé | Poskytovatelé dat specifická pro konkrétní platformu | |
| LeapMotion | Podpora ovladače UltraLeap Leap Motion. | |
| OpenVR | Podpora pro zařízení OpenVR. | |
| Oculus | Podpora zařízení Oculus, jako je například Quest. | |
| UnityAR | (Experimentální) Poskytovatel nastavení kamery, který umožňuje použití SADY MRTK s mobilními zařízeními s rozšířenou realitou. | |
| WindowsMixedReality | Podpora Windows Mixed Reality zařízení, 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. | |
| MRTK/SDK | ||
| Experimentální | Experimentální funkce, včetně shaderů, ovládacích prvků uživatelského rozhraní a jednotlivých správců systémů | |
| Funkce | Funkce, která je založena na balíčku Foundation. | |
| Profily | Výchozí profily pro systémy a služby Microsoft Mixed Reality Toolkit. | |
| 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 | Systém implementuje v diagnostice aplikací, například vizuální profiler. | |
| InputSystem | Systém poskytující podporu přístupu a zpracování uživatelských vstupů. | |
| SceneSystem | Systém poskytující podporu aplikací s více scén. | |
| SpatialAwarenessSystem | Systém poskytující podporu pro povědomí o prostředí uživatele. | |
| TeleportSystem | Systém poskytující podporu pro teleportování (pohyb o zkušenostech ve skokech). |
Závislosti:
- Standardní prostředky (
com.microsoft.mixedreality.toolkit.standardassets)
Standardní prostředky
Balíček standardních prostředků (com.microsoft.mixedreality.toolkit.standardassets) je kolekce komponent, které se doporučují pro všechna prostředí hybridní reality, včetně:
- MRTK Standardní shader
- Základní materiály s použitím standardního shaderu MRTK
- Zvukové soubory
- Písma
- Textury
- Ikony
Poznámka
Aby nedošlo k způsobujícím změnám založeným na definicích sestavení, nejsou skripty používané k řízení některých funkcí standardního shaderu MRTK součástí standardního balíčku 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í
Balíček volitelných rozšíření (com.microsoft.mixedreality.toolkit.extensions) obsahuje další komponenty, které rozšiřují funkce MRTK.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/ Rozšíření | ||
| HandPhysicsService | Služba, která přidává podporu fyziky pro kloubové ruce. | |
| LostTrackingService | Služba, která zjednodušuje předávání ztrát sledování na Microsoft HoloLens zařízeních. | |
| SceneTransitionService | Služba, která zjednodušuje přidávání hladkých přechodů scén. | |
| Vzorky~ | Skrytá složka (v Editoru Unity), která obsahuje ukázkové scény a prostředky. |
Další podrobnosti o procesu používání balíčků obsahujících ukázkové projekty najdete v článku Mixed Reality Toolkit a Unity Package Manager.
Závislosti:
- Základ (
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 vytváření 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 s vytvářením služeb rozšíření. | |
| MigrationWindow | Nástroj, který pomáhá s aktualizací kódu, který používá zastaralé komponenty MRTK. | |
| Optimalizovat Windows | Nástroj, který vám pomůže automatizovat konfiguraci projektu hybridní reality pro zajištění nejlepšího výkonu v Unity. | |
| ReserializeAssetsUtility | Poskytuje podporu pro reserializaci konkrétních souborů Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Nástroj umožňující vývojářům rychle určit mapování Unity pro hardwarové kontrolery. | |
| ScreenshotUtility | Umožňuje zachytávání imagí aplikací v editoru Unity. | |
| TextureCombinerWindow | Nástroj pro kombinování grafických textur. | |
| Sada nástrojů | Uživatelské rozhraní, které usnadňuje zjišťování a používání komponent uživatelského rozhraní MRTK. |
Závislosti:
- Základ (
com.microsoft.mixedreality.toolkit.foundation)
Testovací balíček nástrojů
Balíček volitelných testovacích nástrojů (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ášť užitečné pro vývojáře vytvářející komponenty MRTK.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Testy | ||
| TestUtilities | Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro ruční simulaci |
Závislosti:
- Základ (
com.microsoft.mixedreality.toolkit.foundation)
Balíček příkladů
Balíček příkladů (com.microsoft.mixedreality.toolkit.examples) je strukturovaný tak, aby vývojáři mohli importovat jenom příklady, které vás zajímají.
Další podrobnosti o procesu používání balíčků obsahujících ukázkové projekty najdete v článku o sadě Mixed Reality Toolkit a Unity Package Manageru.
| Složka | Komponenta | Popis |
|---|---|---|
| MRTK/Příklady | ||
| Vzorky~ | Skrytá složka (v Editoru Unity), která obsahuje ukázkové scény a prostředky. | |
| Standardníassets | Společné prostředky sdílené několika ukázkovými scénami. |
Závislosti:
- Základ (
com.microsoft.mixedreality.toolkit.foundation) - Rozšíření (
com.microsoft.mixedreality.toolkit.extensions)