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ängligt för Unity 2018.4 och senare
- Enkelt 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 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.
MRTK Foundation Package
MRTK Foundation-paketet innehåller följande.
| Mapp | Komponent | Beskrivning |
|---|---|---|
| MRTK/Core | Gränssnitts- och typdefinitioner, basklasser, standardskuggare. | |
| MRTK/Core/Providers | Plattformsoberoende dataprovidrar | |
| 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) Kamerainstä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 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).
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
- Cleaner 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
- Nödvändiga 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ä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 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) Kamerainstä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/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). |
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 som använder MRTK Standard Shader
- 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 paketet med standardtillgångar. Dessa skript finns i foundation-paketet 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 för 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. | |
| 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 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/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 | Gör det möjligt att samla in 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 | ||
| 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)