MRTK-paket – MRTK2

MRTK (Mixed Reality Toolkit) är en samling paket som möjliggör plattformsoberoende Mixed Reality programutveckling genom att ge stöd för Mixed Reality maskinvara och plattformar.

MRTK är tillgängligt som tillgångspaket (.unitypackage) och via Unity Package Manager.

Tillgångspaket

MRTK-tillgången (.unitypackage) kan laddas ned från GitHub.

Några av fördelarna med att använda tillgångspaket är:

  • Tillgängligt för Unity 2018.4 och senare
  • Lätt att göra ändringar i MRTK
    • MRTK finns i mappen Assets

Följande är några av utmaningarna:

  • MRTK är en del av projektets assets-mapp, vilket leder till
    • Större projekt
    • Långsammare kompileringstider
  • Ingen beroendehantering
    • Kunder måste lösa paketberoenden manuellt
  • Manuell uppdateringsprocess
    • Flera steg
    • Uppdateringar av stor (över 3 000 filer) källkontroll
    • Risk för att förlora ändringar som gjorts i MRTK
  • Att importera exempelpaketet innebär vanligtvis att inkludera alla exempel

De tillgängliga paketen är:

Dessa paket släpps och stöds av Microsoft från källkoden på GitHub.

Foundation-paket

Mixed Reality Toolkit Foundation är den koduppsättning som gör det möjligt för ditt program att utnyttja gemensamma funktioner på Mixed Reality Plattformar.

Pakage foundationMRTK Foundation-paket

MRTK Foundation-paketet innehåller följande.

Mapp Komponent Beskrivning
MRTK/Core Gränssnitts- och typdefinitioner, basklasser, standardskuggare.
MRTK/Core/Providers Plattformsoberoende dataleverantörer
Händer Basklassstöd och tjänster för handspårning.
InputAnimation Stöd för att registrera data för huvudförflyttning och handspårning.
InputSimulation Stöd för redigeringssimulering av hand- och ögoninmatning.
ObjectMeshObserver Övervakare av rumslig medvetenhet med hjälp av en 3D-modell som data.
UnityInput Vanliga indataenheter (joystick, mus osv.) som implementeras via Unitys indata-API.
MRTK/Providers Plattformsspecifika dataleverantörer
LeapMotion Stöd för UltraLeap Leap Motion-styrenheten.
OpenVR Stöd för OpenVR-enheter.
Oculus Stöd för Oculus-enheter, till exempel Quest.
UnityAR (Experimentell) Kamera inställningsprovider som aktiverar MRTK-användning med mobila AR-enheter.
WindowsMixedReality Stöd för Windows Mixed Reality enheter, inklusive Microsoft HoloLens och integrerande headset.
Windows Stöd för Microsoft Windows specifika API:er, till exempel tal och diktering.
XR SDK (Experimentell) Stöd för Unitys nya XR-ramverk i Unity 2019.3 och senare.
MRTK/SDK
Experimentell Experimentella funktioner, inklusive skuggningar, användargränssnittskontroller och enskilda systemhanterare.
Funktioner Funktioner som bygger på Foundation-paketet.
Profiler Standardprofiler för Microsoft Mixed Reality Toolkit-system och -tjänster.
StandardAssets Gemensamma tillgångar; modeller, texturer, material osv.
MRTK/SceneSystemResources Tillgångar och resurser som används av scensystemet
MRTK/Tjänster
BoundarySystem System som implementerar VR-gränsstöd.
CameraSystem System som implementerar kamerakonfiguration och hantering.
DiagnosticsSystem System implementera i programdiagnostik, till exempel en visuell profilerare.
InputSystem System som ger stöd för åtkomst till och hantering av användarindata.
SceneSystem System som tillhandahåller stöd för program med flera scenar.
SpatialAwarenessSystem System som ger stöd för medvetenhet om användarens miljö.
TeleportSystem System som ger stöd för teleportering (flytta om upplevelsen i hopp).
MRTK/StandardAssets MRTK Standard Shader, grundläggande material och andra standardtillgångar för upplevelser med mixad verklighet

Tilläggspaket

Det valfria paketet Microsoft.MixedRealityToolkit.Unity.Extensions innehåller ytterligare tjänster som utökar funktionerna i Microsoft Mixed Reality Toolkit.

Anteckning

Tilläggspaketet kräver Microsoft.MixedRealityToolkit.Unity.Foundation.

Mapp Komponent Beskrivning
MRTK/Tillägg
HandPhysicsService Tjänst som lägger till fysikstöd till ledade händer.
LostTrackingService Tjänst som förenklar hanteringen av spårningsförluster på Microsoft HoloLens enheter.
SceneTransitionService Tjänst som förenklar tillägg av smidiga scenövergångar.

Verktygspaket

Det valfria Microsoft.MixedRealityToolkit.Unity.Tools-paketet innehåller användbara verktyg som förbättrar utvecklingsupplevelsen för mixad verklighet med hjälp av Microsoft Mixed Reality Toolkit. Dessa verktyg finns på menyn Mixed Reality Toolkit > Utilities i Unity-redigeraren.

Anteckning

Verktygspaketet kräver Microsoft.MixedRealityToolkit.Unity.Foundation.

Mapp Komponent Beskrivning
MRTK/Tools
SkapaWindow Verktyg som förenklar processen med att skapa och distribuera UWP-program.
DependencyWindow Verktyg som skapar ett beroendediagram över tillgångar i ett projekt.
ExtensionServiceCreator Guide som hjälper dig att skapa tilläggstjänster.
MigreringWindow Verktyg som hjälper dig att uppdatera kod som använder inaktuella MRTK-komponenter.
OptimeraWindow Verktyg för att automatisera konfigurationen av ett mixed reality-projekt för bästa prestanda i Unity.
ReserializeAssetsUtility Ger stöd för omialisering av specifika Unity-filer.
RuntimeTools/Tools/ControllerMappingTool Verktyg som gör det möjligt för utvecklare att snabbt fastställa Unity-mappningar för maskinvarustyrenheter.
SkärmbildUtility Aktiverar insamling av programbilder i Unity-redigeraren.
TextureCombinerWindow Verktyg för att kombinera grafikstrukturer.
Verktygslådan Användargränssnitt som gör det enkelt att identifiera och använda MRTK UX-komponenter.

Testverktygspaket

Det valfria Microsoft.MixedRealityToolkit.TestUtilities-paketet är en samling hjälpskript som gör det möjligt för utvecklare att enkelt skapa spellägestester. Dessa verktyg är särskilt användbara för utvecklare som skapar MRTK-komponenter.

Mapp Komponent Beskrivning
MRTK/Tester
TestVerktyg Metoder för att förenkla skapandet av spellägestester, inklusive handsimuleringsverktyg.

Exempelpaket

Exempelpaketet innehåller demonstrationer, exempelskript och exempelscener som utövar funktioner i grundpaketet. Det här paketet innehåller HandInteractionExample-scenen (bilden nedan) som innehåller exempelobjekt som svarar på olika typer av handindata (ledade och icke-ledade).

HandInteractionExample scene

Det här paketet innehåller även demonstrationer för ögonspårning som dokumenteras här

Mer allmänt bör alla nya funktioner i MRTK innehålla ett motsvarande exempel i exempelpaketet, ungefär efter samma mappstruktur och plats.

Anteckning

Exempelpaketet kräver Microsoft.MixedRealityToolkit.Unity.Foundation.

Mapp Komponent Beskrivning
MRTK/exempel
Demos Enkla scener som illustrerar en eller två relaterade funktioner.
Experimentell Demoscener som illustrerar experimentella funktioner.
StandardAssets Vanliga tillgångar som delas av flera demoscener.

Unity Package Manager

För upplevelser som skapas med Unity 2019.4 och senare är MRTK tillgängligt via Unity Package Manager.

Några av fördelarna med att använda tillgångspaket är:

  • Mindre projekt
    • Renare Visual Studio lösningar
    • Färre filer att checka in (MRTK är en enkel referens i Packages/manifest.json filen)
  • Snabbare kompilering
    • Unity behöver inte kompilera om MRTK under bygget
  • Beroendematchning
    • Nödvändiga MRTK-paket installeras automatiskt när paket med beroenden anges
  • Enkel uppdatering till nya MRTK-versioner
    • Ändra versionen i Packages/manifest.json filen

Följande är några av utmaningarna:

  • MRTK är oföränderligt
    • Det går inte att göra ändringar utan att de tas bort under paketmatchningen
  • MRTK stöder inte UPM-paket med Unity 2018.4

Foundation-paket

Grundpaketet (com.microsoft.mixedreality.toolkit.foundation) utgör grunden för Mixed Reality Toolkit.

Mapp Komponent Beskrivning
MRTK/Core Gränssnitts- och typdefinitioner, basklasser, standardskuggning.
MRTK/Core/Providers Plattformsoberoende dataprovidrar
Händer Basklassstöd och tjänster för handspårning.
InputAnimation Stöd för registrering av huvudflytt och handspårningsdata.
InputSimulation Stöd för redigeringssimulering av hand- och ögoninmatning.
ObjectMeshObserver Rumslig medvetenhetsobservatör med hjälp av en 3D-modell som data.
UnityInput Vanliga indataenheter (joystick, mus osv.) som implementeras via Unitys indata-API.
MRTK/Providers Plattformsspecifika dataprovidrar
LeapMotion Stöd för UltraLeap Leap Motion-styrenheten.
OpenVR Stöd för OpenVR-enheter.
Oculus Stöd för Oculus-enheter, till exempel Quest.
UnityAR (Experimentell) Kamera inställningsprovider som aktiverar MRTK-användning med mobila AR-enheter.
WindowsMixedReality Stöd för Windows Mixed Reality enheter, inklusive Microsoft HoloLens och uppslukande headset.
Windows Stöd för Microsoft Windows specifika API:er, till exempel tal och diktering.
XR SDK (Experimentell) Stöd för Unitys nya XR-ramverk i Unity 2019.3 och senare.
MRTK/SDK
Experimentell Experimentella funktioner, inklusive skuggor, användargränssnittskontroller och enskilda systemhanterare.
Funktioner Funktioner som bygger på Foundation-paketet.
Profiler Standardprofiler för Microsoft Mixed Reality Toolkit-system och -tjänster.
StandardAssets Gemensamma tillgångar; modeller, texturer, material osv.
MRTK/Tjänster
BoundarySystem System som implementerar stöd för VR-gränser.
CameraSystem System som implementerar kamerakonfiguration och hantering.
DiagnosticsSystem Systemintegrering i programdiagnostik, till exempel en visuell profilerare.
InputSystem System som ger stöd för åtkomst och hantering av användarindata.
SceneSystem System som tillhandahåller stöd för program med flera scenar.
SpatialAwarenessSystem System som ger stöd för medvetenhet om användarens miljö.
TeleportSystem System som ger stöd för teleportering (flytta om upplevelsen i hopp).

Beroenden:

  • Standardtillgångar (com.microsoft.mixedreality.toolkit.standardassets)

Standardtillgångar

Standardpaketet för tillgångar (com.microsoft.mixedreality.toolkit.standardassets) är en samling komponenter som rekommenderas för alla upplevelser med mixad verklighet, inklusive:

  • MRTK Standard-skuggning
  • Grundläggande material med hjälp av MRTK Standard-skuggning
  • Ljudfiler
  • Teckensnitt
  • Bakgrunder
  • Ikoner

Anteckning

För att undvika icke-bakåtkompatibla ändringar baserat på sammansättningsdefinitioner ingår inte de skript som används för att styra vissa funktioner i MRTK Standard-skuggningen i standardpaketet för tillgångar. Dessa skript finns i grundpaketet i MRTK/Core/Utilities/StandardShader mappen .

Beroenden: ingen

Tilläggspaket

Det valfria tilläggspaketet (com.microsoft.mixedreality.toolkit.extensions) innehåller ytterligare komponenter som utökar funktionerna i MRTK.

Mapp Komponent Beskrivning
MRTK/Tillägg
HandPhysicsService Tjänst som lägger till fysikstöd till ledade händer.
LostTrackingService Tjänst som förenklar överlämnande av spårningsförluster på Microsoft HoloLens enheter.
SceneTransitionService Tjänst som förenklar tillägg av smidiga scenövergångar.
Exempel ~ En dold mapp (i Unity Editor) som innehåller exempelscener och tillgångar.

Mer information om hur du använder paket som innehåller exempelprojekt finns i artikeln Mixed Reality Toolkit och Unity Package Manager.

Beroenden:

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

Verktygspaket

Det valfria verktygspaketet (com.microsoft.mixedreality.toolkit.tools) innehåller verktyg som är användbara för att skapa upplevelser med mixad verklighet. I allmänhet är dessa verktyg redigeringskomponenter och deras kod levereras inte som en del av ett program.

Mapp Komponent Beskrivning
MRTK/Tools
SkapaWindow Verktyg som förenklar processen med att skapa och distribuera UWP-program.
DependencyWindow Verktyg som skapar ett beroendediagram över tillgångar i ett projekt.
ExtensionServiceCreator Guide som hjälper dig att skapa tilläggstjänster.
MigreringWindow Verktyg som hjälper dig att uppdatera kod som använder inaktuella MRTK-komponenter.
OptimeraWindow Verktyg för att automatisera konfigurationen av ett mixed reality-projekt för bästa prestanda i Unity.
ReserializeAssetsUtility Ger stöd för omialisering av specifika Unity-filer.
RuntimeTools/Tools/ControllerMappingTool Verktyg som gör det möjligt för utvecklare att snabbt fastställa Unity-mappningar för maskinvarustyrenheter.
SkärmbildUtility Aktiverar insamling av programbilder i Unity-redigeraren.
TextureCombinerWindow Verktyg för att kombinera grafikstrukturer.
Verktygslådan Användargränssnitt som gör det enkelt att identifiera och använda MRTK UX-komponenter.

Beroenden:

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

Testverktygspaket

Det valfria testverktygspaketet (com.microsoft.mixedreality.toolkit.testutilities) innehåller en samling hjälpskript som gör det möjligt för utvecklare att enkelt skapa test av uppspelningsläge. Dessa verktyg är särskilt användbara för utvecklare som skapar MRTK-komponenter.

Mapp Komponent Beskrivning
MRTK/Tester
Testverktyg Metoder för att förenkla skapandet av spellägestester, inklusive verktyg för handsimulering.

Beroenden:

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

Exempelpaket

Exempelpaketet (com.microsoft.mixedreality.toolkit.examples) är strukturerat så att utvecklare endast kan importera de intressanta exemplen.

Mer information om hur du använder paket som innehåller exempelprojekt finns i artikeln Mixed Reality Toolkit och Unity Package Manager.

Mapp Komponent Beskrivning
MRTK/exempel
Exempel~ En dold mapp (i Unity Editor) som innehåller exempelscener och tillgångar.
StandardAssets Vanliga tillgångar som delas av flera demoscener.

Beroenden:

  • Foundation (com.microsoft.mixedreality.toolkit.foundation)
  • Tillägg (com.microsoft.mixedreality.toolkit.extensions)

Se även