Dela via

MRTK-paket – MRTK2

Mixed Reality Toolkit (MRTK) ä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änglig för Unity 2018.4 och senare
  • Enkelt att göra ändringar i MRTK
    • MRTK finns i mappen Tillgångar

Följande är några av utmaningarna:

  • MRTK är en del av projektets resursmapp, vilket leder till
    • Större projekt
    • Långsammare kompileringstider
  • Ingen beroendehantering
    • Kunder måste lösa paketberoenden manuellt
  • Manuell uppdateringsprocess
    • Flera steg
    • Stora (3 000+ fil) uppdateringar av 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 att ditt program kan använda vanliga funktioner på Mixed Reality-plattformar.

Pakage foundation MRTK Foundation-paket

MRTK Foundation-paketet innehåller följande.

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 ögonindata.
ObjectMeshObserver Spatial 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) Kamerainställningar 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 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/Services
BoundarySystem System som implementerar stöd för VR-gräns.
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 mixade verklighetsupplevelser

Tilläggspaket

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

Kommentar

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 Microsoft Mixed Reality Toolkit. De här verktygen finns på menyn Mixed Reality Toolkit > Utilities i Unity-redigeraren.

Kommentar

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

Mapp Komponent beskrivning
MRTK/Verktyg
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 Möjliggör insamling av programbilder i Unity-redigeraren.
TextureCombinerWindow Verktyg för att kombinera grafikstrukturer.
Verktygslåda 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 tränar funktioner i grundpaketet. Det här paketet innehåller HandInteractionExample-scenen (bilden nedan) som innehåller exempelobjekt som svarar på olika typer av handindata (artikulerade och icke-artikulerade).

HandInteractionExample-scen

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.

Kommentar

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
    • Obligatoriska 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änderlig
    • 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 ögonindata.
ObjectMeshObserver Spatial 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) Kamerainställningar 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 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/Services
BoundarySystem System som implementerar stöd för VR-gräns.
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).

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 shader
  • Grundläggande material med hjälp av MRTK Standard Shader
  • Ljudfiler
  • Teckensnitt
  • Bakgrunder
  • Ikoner

Kommentar

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 hantering av spårningsförluster på Microsoft HoloLens-enheter.
SceneTransitionService Tjänst som förenklar tillägg av smidiga scenövergångar.
Prover~ 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 mixade verklighetsupplevelser. I allmänhet är dessa verktyg redigeringskomponenter och deras kod levereras inte som en del av ett program.

Mapp Komponent beskrivning
MRTK/Verktyg
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 Möjliggör insamling av programbilder i Unity-redigeraren.
TextureCombinerWindow Verktyg för att kombinera grafikstrukturer.
Verktygslåda 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 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.

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
Prover~ 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