Balíčky MRTK

Sada Mixed Reality Toolkit (MRTK) je kolekce balíčků, které umožňují vývoj aplikací pro Mixed Reality platformy tím, že poskytují podporu Mixed Reality hardwaru a platforem.

MRTK je k dispozici jako balíčky assetu (.unitypackage) a prostřednictvím unity Správce balíčků.

Balíčky prostředků

Asset MRTK (.unitypackage) si můžete stáhnout z GitHub.

Mezi výhody používání balíčků prostředků patří:

  • K dispozici pro Unity 2018.4 a novější
  • Snadné provedení 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í řešit závislosti balíčků ručně.
  • Ruční proces aktualizace
    • Několik 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 ze zdrojového kódu ve mrtk_release na GitHub.

Balíček Foundation

The Mixed Reality Toolkit Foundation je sada kódu, která vaší aplikaci umožňuje využívat běžné funkce napříč Mixed Reality platformami.

Pakage foundation Základní balíček MRTK

Základní balíček MRTK obsahuje následující informace.

Složka Komponenta Popis
MRTK/Core Definice rozhraní a typů, základní třídy, standardní shader.
MRTK, jádro nebo poskytovatelé Poskytovatelé dat agnostických platforem
Ruce Podpora základních tříd a služby pro ruční sledování.
InputAnimation Podpora záznamu pohybu hlavy a dat sledování rukou
InputSimulation (Výpočet vstupu) Podpora pro simulaci vstupu do rukou a očí v editoru
Objekt MeshObserver Pozorovatel prostorového povědomí, 3D model jako data používá návěsí.
UnityInput Běžná vstupní zařízení (stick, myš atd.) implementovaná prostřednictvím vstupního rozhraní API Unity.
MRTK / Poskytovatelé Poskytovatelé dat pro konkrétní platformu
LeapMotion Podpora kontroleru UltraLeap Leap Motion
OpenVR Podpora zařízení s OpenVR
Oculus Podpora pro zařízení Oculus, jako je Například
UnityAR (Experimentální) Poskytovatel nastavení fotoaparátu, který umožňuje mrtk používat s mobilními zařízeními ar.
WindowsMixedReality Podpora pro Windows Mixed Reality zařízení, včetně Microsoft HoloLens a imerzivních náhlavních souprav.
Windows Podpora microsoftu Windows rozhraní API, 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 systémových manažerů
Funkce Funkce, která vychází z balíčku Foundation.
Profily Výchozí profily pro Mixed Reality Toolkit a služby Microsoftu.
StandardAssets Běž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 implementující podporu hranic VR
Systém fotoaparátu Systém implementující konfiguraci a správu fotoaparátu
DiagnosticsSystem Systém implementující diagnostiku aplikace, například profiler vizuálu.
Vstupní systém Systém poskytuje podporu pro přístup a zpracování uživatelského vstupu.
Systém scény Systém poskytující podporu více scén aplikací.
SpatialAwarenessSystem Systém poskytuje podporu pro informovanost o prostředí uživatele.
TeleportSystem Systém poskytuje podporu pro teleportování (přesouvání prostředí v skokech).
MRTK/StandardAssets MRTK Standard 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 pro artikulované ruce.
LostTrackingService Služba, která zjednodušuje zpracování ztráty sledování na Microsoft HoloLens zařízeních.
SceneTransitionService Služba, která zjednodušuje přidávání hladkých přechodů scény.

Balíček Nástroje

Volitelný balíček Microsoft.MixedRealityToolkit.Unity.Tools obsahuje užitečné nástroje, které vylepšují vývojové prostředí hybridní reality pomocí sady Microsoft Mixed Reality Toolkit. Tyto nástroje se nacházejí v nabídce Mixed Reality Toolkit > nástroje 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ý zjednodušuje 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í rozšiřujících služeb.
MigraceWindow Nástroj, který pomáhá při aktualizaci kódu, který používá zastaralé komponenty MRTK.
OptimizeWindow Nástroj, který vám pomůže automatizovat konfiguraci projektu hybridní reality pro nejlepší výkon v Unity.
ReserializeAssetsUtility Poskytuje podporu pro reserializaci konkrétních souborů Unity.
RuntimeTools/Tools/ControllerMappingTool Nástroj, který vývojářům umožňuje rychle určit mapování Unity pro hardwarové kontrolery.
Snímek obrazovkyUžití 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.

Balíček testovacích 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 užitečné zejména pro vývojáře, kteří vytvářejí komponenty MRTK.

Složka Komponenta Popis
MRTK / Testy
Nástroje pro testování Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro simulaci rukou

Balíček s příklady

Balíček s příklady obsahuje ukázky, ukázkové skripty a ukázkové scény, které procvičují funkčnost základního 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 ručního vstupu (articulated a non-articulated).

HandInteractionExample scene

Tento balíček obsahuje také ukázky sledování očí, které jsou zde dokumentované.

Obecněji platí, že všechny nové funkce v MRTK by měly obsahovat odpovídající příklad v balíčku příkladů, který zhruba odpovídá stejné struktuře složek a umístění.

Poznámka

Balíček s příklady vyžaduje Microsoft.MixedRealityToolkit.Unity.Foundation.

Složka Komponenta Popis
MRTK / Příklady
Dema Jednoduché scény ilustrují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énymi

Unity – Správce balíčků

Pro prostředí vytvářená pomocí Unity 2019.4 a novějších je MRTK k dispozici prostřednictvím unity Správce balíčků.

Mezi výhody používání balíčků prostředků patří:

  • Menší projekty
    • Čistější Visual Studio řešení
    • Méně souborů ke kontrole (MRTK je jednoduchý odkaz v Packages/manifest.json souboru)
  • Rychlejší kompilace
    • Unity nemusí při sestavování znovu kompilovat MRTK.
  • Řešení závislostí
    • Požadované balíčky MRTK se automaticky instalují při zadávání balíčků se závislostmi.
  • Snadná aktualizace na nové verze MRTK
    • Změna verze v Packages/manifest.json souboru

Příklady problémů, které je potřeba řešit:

  • MrTK je neměnný
    • Během překladu balíčků není možné provádět změny, aniž by byly odebrány.
  • MRTK nepodporuje balíčky UPM s Unity 2018.4

Balíček Foundation

Základní balíček ( com.microsoft.mixedreality.toolkit.foundation ) tvoří základ Mixed Reality Toolkit.

Složka Komponenta Popis
MRTK/Core Definice rozhraní a typů, základní třídy, standardní shader.
MRTK, jádro nebo poskytovatelé Poskytovatelé dat agnostických platforem
Ruce Podpora základních tříd a služby pro ruční sledování.
InputAnimation Podpora záznamu pohybu hlavy a dat sledování rukou
InputSimulation (Výpočet vstupu) Podpora pro simulaci vstupu do rukou a očí v editoru
Objekt MeshObserver Pozorovatel prostorového povědomí, 3D model jako data používá návěsí.
UnityInput Běžná vstupní zařízení (stick, myš atd.) implementovaná prostřednictvím vstupního rozhraní API Unity
MRTK / Poskytovatelé Poskytovatelé dat pro konkrétní platformu
LeapMotion Podpora pro UltraLeap s přestupným pohybem.
OpenVR Podpora pro zařízení OpenVR.
Oculus Podpora pro zařízení Oculus, jako je například Quest.
UnityAR Zkušební Zprostředkovatel nastavení kamery povolující MRTK použití s mobilními zařízeními AR.
WindowsMixedReality podpora Windows Mixed Realitych zařízení, včetně Microsoft HoloLens a atraktivních sluchátek.
Windows podpora pro specifická rozhraní api pro Microsoft Windows, například rozpoznávání řeči a diktování.
SADA XR SDK Zkušební Podpora nového XR architektury 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é jsou založeny na balíčku základní verze.
Profily výchozí profily pro Microsoft Mixed Reality Toolkit systémy a služby.
StandardAssets Běžné prostředky; modely, textury, materiály atd.
MRTK/služby
BoundarySystem Systém implementující podporu ohraničení VR.
CameraSystem Systém implementuje konfiguraci a správu kamery.
DiagnosticsSystem Implementace systému v Application Diagnostics, například vizuální Profiler.
InputSystem Systém poskytující podporu pro přístup k uživatelským vstupům a jejich zpracování.
SceneSystem Systém, který zajišťuje podporu aplikací pro 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 přenos (přechod o prostředí v přeskakování).

Závislosti

  • Standardní prostředky ( com.microsoft.mixedreality.toolkit.standardassets )

Prostředky úrovně Standard

Balíček standardních prostředků ( com.microsoft.mixedreality.toolkit.standardassets) je kolekce komponent, které se doporučují pro všechna hybridní prostředí realit, včetně:

  • MRTK standardní shader
  • Základní materiály používající standardní shader MRTK
  • Zvukové soubory
  • Písma
  • Textury
  • Ikony

Poznámka

Aby nedošlo k zásadním změnám na základě definic sestavení, skripty používané pro řízení některých funkcí standardního shaderu MRTK nejsou zahrnuty do balíčku standardních prostředků. Tyto skripty najdete v balíčku Foundation 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/rozšíření
HandPhysicsService Služba, která přidává podporu fyzika k kloubovým rukou.
LostTrackingService služba, která zjednodušuje sledování ztrát na zařízeních Microsoft HoloLens.
SceneTransitionService Služba, která zjednodušuje přidávání hladkých přechodů scény.
Ukázky ~ Skrytý (ve složce Unity Editor), který obsahuje ukázkové scény a prostředky.

další podrobnosti o procesu použití balíčků, které obsahují ukázkové projekty, najdete v článku Mixed Reality Toolkit a Unity Správce balíčků .

Závislosti

  • Foundation ( 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í hybridních prostředí realit. Obecně platí, že tyto nástroje jsou komponenty editoru a jejich kód se nedodává 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í UWP.
DependencyWindow Nástroj, který vytvoří graf závislosti prostředků v projektu.
ExtensionServiceCreator Průvodce, který vám pomůže při vytváření služeb rozšíření.
MigrationWindow Nástroj, který pomáhá při aktualizaci kódu, který používá zastaralé komponenty MRTK.
OptimizeWindow Nástroj, který pomáhá automatizovat konfiguraci hybridního projektu reality, aby byl nejlepší výkon v Unity.
ReserializeAssetsUtility Poskytuje podporu pro přeserializaci konkrétních souborů Unity.
RuntimeTools/nástroje/ControllerMappingTool Nástroj, který vývojářům umožňuje rychle určit mapování Unity pro řadiče hardwaru.
ScreenshotUtility Povolí zachytávání imagí aplikace v editoru Unity.
TextureCombinerWindow Pomůcka pro kombinování grafických textur.
Sada nástrojů Uživatelské rozhraní usnadňuje zjišťování a používání komponent MRTK UX.

Závislosti

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

Balíček testovacích nástrojů

Volitelný balíček test Utilities ( 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
Nástroje pro testování Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro simulaci rukou

Závislosti:

  • Základ ( com.microsoft.mixedreality.toolkit.foundation )

Balíček s příklady

Balíček příkladů ( ) je strukturovaný tak, aby vývojářům umožnil importovat pouze com.microsoft.mixedreality.toolkit.examples příklady, které vás zajímají.

Další podrobnosti o procesu používání balíčků obsahujících příklady projektů najdete v článku o Mixed Reality Toolkit a Unity Správce balíčků článku.

Složka Komponenta Popis
MRTK / Příklady
Ukázky~ Skrytá složka (ve složce Unity Editor), která obsahuje ukázkové scény a prostředky.
StandardAssets Běžné prostředky sdílené několika ukázkovými scénymi

Závislosti:

  • Základ ( com.microsoft.mixedreality.toolkit.foundation )
  • Rozšíření ( com.microsoft.mixedreality.toolkit.extensions )

Viz také