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.
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).
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.jsonfilen)
- 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.jsonfilen
- Ändra versionen i
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)