Balíčky MRTK

mixed reality Toolkit (MRTK) je kolekce balíčků, které umožňují vývoj aplikací hybridní reality pro různé platformy díky podpoře hybridního hardwaru a platforem pro hybridní realitu.

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

Balíčky assetů

Prostředek MRTK (. unitypackage) je možné stáhnout z GitHub.

Mezi výhody použití balíčků assetů patří:

  • Dostupné pro Unity 2018,4 a novější
  • Snadné provádění změn v MRTK
    • MRTK je ve složce assets (prostředky).

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

  • MRTK je součástí složky assetů projektu, což vede k
    • Větší projekty
    • Pomalejší doba kompilace
  • Žádná Správa závislostí
    • Zákazníci vyžadují ruční řešení závislostí balíčku.
  • Proces ruční aktualizace
    • Více kroků
    • Velké (3000 + soubor) aktualizace správy zdrojového kódu
    • Riziko ztráty změn provedených v MRTK
  • Importování balíčku příkladů obvykle znamená včetně všech příkladů.

K dispozici jsou tyto balíčky:

Tyto balíčky jsou vydány a podporovány společností Microsoft ze zdrojového kódu ve větvi mrtk_release v GitHub.

Základní balíček

Mixed reality Toolkit Foundation je sada kódů, která umožňuje vaší aplikaci využívat běžné funkce napříč různými platformami realit.

Balíček balíčku FoundationMRTK Foundation

Balíček MRTK Foundation obsahuje následující.

Složka Komponenta Popis
MRTK/jádro Definice rozhraní a typů, základní třídy, Standardní shader.
MRTK/Core/Providers Zprostředkovatelé dat nezávislá platformy
Praktick Podpora a služby základní třídy pro zajištění ručního sledování.
InputAnimation Podpora záznamu dat pro přesun a sledování hlav.
InputSimulation Podpora v editoru pro simulaci ruky a vstupu očí.
ObjectMeshObserver Pozorovatel pro povědomí prostorů s použitím 3D model jako dat.
UnityInput Běžná vstupní zařízení (pákový ovladač, myš atd.) implementuje se přes vstupní rozhraní API Unity.
MRTK/poskytovatelé Poskytovatelé dat specifických pro 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/SceneSystemResources Prostředky a prostředky používané systémem scény
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í).
MRTK/StandardAssets MRTK standardní shader, základní materiály a další standardní prostředky pro hybridní realitu

Balíček rozšíření

Volitelný balíček Microsoft. MixedRealityToolkit. Unity. Extensions zahrnuje další služby, které zvyšují funkčnost 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 fyzika k kloubovým rukou.
LostTrackingService služba, která zjednodušuje zpracování 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.

Balíček nástrojů

Volitelný balíček Microsoft. MixedRealityToolkit. Unity. Tools zahrnuje užitečné nástroje, které vylepšují vývojové prostředí pro hybridní realitu pomocí Toolkit Microsoft Mixed reality. tyto nástroje se nacházejí v nabídce nástrojů pro Mixed Reality Toolkit v editoru Unity.

Poznámka

Balíček Tools 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í 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.

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 zvláště 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 simulaci ručního spuštění.

Ukázkový balíček

Ukázkový balíček obsahuje ukázky, ukázkové skripty a ukázkové scény, které v balíčku základní aplikace vykonává funkčnost. Tento balíček obsahuje HandInteractionExample scénu (obrázek uvedený níže), která obsahuje ukázkové objekty, které reagují na různé typy ručního vstupu (kloubové a nekloubové).

HandInteractionExampleá scéna

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

Obecně platí, že jakákoli nová funkce v MRTK by měla obsahovat odpovídající příklad v balíčku příklady, a to přibližně za stejnou strukturu a umístění složky.

Poznámka

Balíček příkladů vyžaduje Microsoft. MixedRealityToolkit. Unity. Foundation.

Složka Komponenta Popis
MRTK/příklady
Ukázky 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é více ukázkami scény.

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žití balíčků assetů patří:

  • Menší projekty
    • čisticí Visual Studio řešení
    • Méně souborů k vrácení se změnami (MRTK je v souboru jednoduchý odkaz Packages/manifest.json )
  • Rychlejší kompilace
    • Unity není potřeba při sestavování překompilovat MRTK
  • Řešení závislostí
    • Při určování balíčků se závislostmi se automaticky nainstalují požadované balíčky MRTK.
  • Snadná aktualizace nových verzí MRTK
    • Změna verze v Packages/manifest.json souboru

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

  • MRTK je neměnný.
    • Nelze provést změny, aniž by byly odebrány během překladu balíčku.
  • 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 hybridní Reality Toolkit.

Složka Komponenta Popis
MRTK/jádro Definice rozhraní a typů, základní třídy, Standardní shader.
MRTK/Core/Providers Zprostředkovatelé dat nezávislá platformy
Praktick Podpora a služby základní třídy pro zajištění ručního sledování.
InputAnimation Podpora záznamu dat pro přesun a sledování hlav.
InputSimulation Podpora v editoru pro simulaci ruky a vstupu očí.
ObjectMeshObserver Pozorovatel pro povědomí prostorů s použitím 3D model jako dat.
UnityInput Běžná vstupní zařízení (pákový ovladač, myš atd.) implementuje se přes vstupní rozhraní API Unity.
MRTK/poskytovatelé Poskytovatelé dat specifických pro 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
TestUtilities Metody pro zjednodušení vytváření testů režimu přehrávání, včetně nástrojů pro simulaci ručního spuštění.

Závislosti

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

Ukázkový balíček

Balíček příkladů ( com.microsoft.mixedreality.toolkit.examples ) je strukturovaný a umožňuje vývojářům importovat pouze příklady zájmu.

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ů .

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

Závislosti

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )
  • Rozšíření ( com.microsoft.mixedreality.toolkit.extensions )

Viz také