MRTK-pakketten — MRTK2
Mixed Reality Toolkit (MRTK) is een verzameling pakketten die platformoverschrijdende Mixed Reality toepassingsontwikkeling mogelijk maken door ondersteuning te bieden voor Mixed Reality hardware en platforms.
MRTK is beschikbaar als assetpakketten (.unitypackage) en via Unity Package Manager.
Assetpakketten
De MRTK-asset (.unitypackage) kan worden gedownload van GitHub.
Enkele voordelen van het gebruik van assetpakketten zijn:
- Beschikbaar voor Unity 2018.4 en hoger
- Eenvoudig wijzigingen aan te brengen in MRTK
- MRTK bevindt zich in de map Assets
Voorbeelden van problemen zijn:
- MRTK maakt deel uit van de map Assets van het project, wat leidt tot
- Grotere projecten
- Tragere compilatietijden
- Geen afhankelijkheidsbeheer
- Klanten zijn verplicht om pakketafhankelijkheden handmatig op te lossen
- Handmatig updateproces
- Meerdere stappen
- Grote (3000+ bestand) broncodebeheerupdates
- Risico op verlies van wijzigingen in MRTK
- Het importeren van het voorbeeldenpakket betekent meestal dat alle voorbeelden worden opgenomen
De beschikbare pakketten zijn:
Deze pakketten worden uitgebracht en ondersteund door Microsoft vanuit broncode op GitHub.
Basispakket
De Mixed Reality Toolkit Foundation is de set code waarmee uw toepassing gebruikmaakt van algemene functionaliteit op Mixed Reality Platforms.
MRTK Foundation Package
Het MRTK Foundation-pakket bevat het volgende.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Core | Interface- en typedefinities, basisklassen, standaard shader. | |
| MRTK/Core/Providers | Platformonafhankelijke gegevensproviders | |
| Handen | Basisklasseondersteuning en -services voor handtracering. | |
| InputAnimation | Ondersteuning voor het opnemen van hoofdbewegingen en handtraceringsgegevens. | |
| InputSimulation | Ondersteuning voor in-editor simulatie van hand- en ooginvoer. | |
| ObjectMeshObserver | Waarnemer van ruimtelijk bewustzijn met behulp van een 3D-model als de gegevens. | |
| UnityInput | Algemene invoerapparaten (stick, muis, enzovoort) geïmplementeerd via de invoer-API van Unity. | |
| MRTK/Providers | Platformspecifieke gegevensproviders | |
| LeapMotion | Ondersteuning voor de UltraLeap Leap Motion-controller. | |
| OpenVR | Ondersteuning voor OpenVR-apparaten. | |
| Oculus | Ondersteuning voor Oculus-apparaten, zoals de Quest. | |
| UnityAR | (Experimenteel) Provider van camera-instellingen die MRTK-gebruik met mobiele AR-apparaten inschakelen. | |
| WindowsMixedReality | Ondersteuning voor Windows Mixed Reality apparaten, waaronder Microsoft HoloLens en insluitende headsets. | |
| Windows | Ondersteuning voor microsoft Windows-specifieke API's, bijvoorbeeld spraak en dicteren. | |
| XR SDK | (Experimenteel) Ondersteuning voor het nieuwe XR-framework van Unity in Unity 2019.3 en hoger. | |
| MRTK/SDK | ||
| Experimenteel | Experimentele functies, waaronder shaders, besturingselementen voor gebruikersinterfaces en afzonderlijke systeembeheerders. | |
| Functies | Functionaliteit die voortbouwt op het Foundation-pakket. | |
| Profielen | Standaardprofielen voor de Microsoft Mixed Reality Toolkit-systemen en -services. | |
| StandardAssets | Gemeenschappelijke activa; modellen, patronen, materialen, enzovoort. | |
| MRTK/SceneSystemResources | Assets en resources die worden gebruikt door het Scènesysteem | |
| MRTK/Services | ||
| BoundarySystem | Systeem waarmee VR-grensondersteuning wordt geïmplementeerd. | |
| CameraSystem | Systeem dat cameraconfiguratie en -beheer implementeert. | |
| DiagnosticsSystem | Systeemialisatie in toepassingsdiagnose, bijvoorbeeld een visual profiler. | |
| InputSystem | Systeem dat ondersteuning biedt voor toegang tot en verwerking van gebruikersinvoer. | |
| SceneSystem | Systeem dat ondersteuning biedt voor toepassingen met meerdere scènes. | |
| SpatialAwarenessSystem | Systeem dat ondersteuning biedt voor het bewust zijn van de omgeving van de gebruiker. | |
| TeleportSystem | Systeem dat ondersteuning biedt voor teleporteren (verplaatsen over de ervaring in sprongen). | |
| MRTK/StandardAssets | MRTK Standard shader, basismaterialen en andere standaardassets voor mixed reality-ervaringen |
Uitbreidingspakket
Het optionele pakket Microsoft.MixedRealityToolkit.Unity.Extensions bevat aanvullende services die de functionaliteit van Microsoft Mixed Reality Toolkit uitbreiden.
Notitie
Voor het uitbreidingspakket is Microsoft.MixedRealityToolkit.Unity.Foundation vereist.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Extensies | ||
| HandPhysicsService | Service waarmee fysicaondersteuning wordt toegevoegd aan gelekte handen. | |
| LostTrackingService | Service die het bijhouden van verlies op Microsoft HoloLens apparaten vereenvoudigt. | |
| SceneTransitionService | Service die het toevoegen van soepele scèneovergangen vereenvoudigt. |
Pakket Hulpprogramma's
Het optionele pakket Microsoft.MixedRealityToolkit.Unity.Tools bevat handige hulpprogramma's die de mixed reality-ontwikkelervaring verbeteren met behulp van Microsoft Mixed Reality Toolkit. Deze hulpprogramma's bevinden zich in het menu Mixed Reality Toolkit > Hulpprogramma's in de Unity Editor.
Notitie
Voor het hulpprogrammapakket is Microsoft.MixedRealityToolkit.Unity.Foundation vereist.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Hulpprogramma's | ||
| BuildWindow | Hulpprogramma waarmee u het proces van het bouwen en implementeren van UWP-toepassingen kunt vereenvoudigen. | |
| DependencyWindow | Hulpprogramma waarmee een afhankelijkheidsgrafiek van assets in een project wordt gemaakt. | |
| ExtensionServiceCreator | Wizard voor hulp bij het maken van extensieservices. | |
| MigrationWindow | Hulpprogramma dat helpt bij het bijwerken van code die gebruikmaakt van afgeschafte MRTK-onderdelen. | |
| OptimizeWindow | Hulpprogramma voor het automatiseren van het configureren van een mixed reality-project voor de beste prestaties in Unity. | |
| ReserializeAssetsUtility | Biedt ondersteuning voor het wijzigen van het formaat van specifieke Unity-bestanden. | |
| RuntimeTools/Tools/ControllerMappingTool | Hulpprogramma waarmee ontwikkelaars snel Unity-toewijzingen voor hardwarecontrollers kunnen bepalen. | |
| ScreenshotUtility | Hiermee schakelt u het vastleggen van toepassingsinstallatiekopieën in de Unity-editor in. | |
| TextureCombinerWindow | Hulpprogramma voor het combineren van grafische patronen. | |
| Toolbox | Gebruikersinterface waarmee u MRTK UX-onderdelen gemakkelijk kunt detecteren en gebruiken. |
Pakket hulpprogramma's testen
Het optionele pakket Microsoft.MixedRealityToolkit.TestUtilities is een verzameling helperscripts waarmee ontwikkelaars eenvoudig afspeelmodustests kunnen maken. Deze hulpprogramma's zijn vooral handig voor ontwikkelaars die MRTK-onderdelen maken.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Tests | ||
| Testhulpprogramma's | Methoden om het maken van afspeelmodustests te vereenvoudigen, inclusief hulpprogramma's voor handsimulatie. |
Voorbeeldenpakket
Het voorbeeldenpakket bevat demo's, voorbeeldscripts en voorbeeldscènes die functionaliteit in het basispakket uitoefenen. Dit pakket bevat de scène HandInteractionExample (hieronder afgebeeld) die voorbeeldobjecten bevat die reageren op verschillende typen handinvoer (gearceerd en niet-gearceerd).
Dit pakket bevat ook demo's voor oogtracering, die hier worden beschreven
Over het algemeen moet elke nieuwe functie in MRTK een bijbehorend voorbeeld bevatten in het voorbeeldenpakket, ongeveer volgens dezelfde mapstructuur en locatie.
Notitie
Voor het voorbeeldenpakket is Microsoft.MixedRealityToolkit.Unity.Foundation vereist.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Voorbeelden | ||
| Demos | Eenvoudige scènes die een of twee gerelateerde functies illustreren. | |
| Experimenteel | Demoscènes met experimentele functies. | |
| StandardAssets | Algemene assets die worden gedeeld door meerdere demoscènes. |
Unity Package Manager
Voor ervaringen die worden gemaakt met Unity 2019.4 en hoger, is MRTK beschikbaar via Unity Package Manager.
Enkele voordelen van het gebruik van assetpakketten zijn:
- Kleinere projecten
- Cleaner Visual Studio-oplossingen
- Minder bestanden om in te checken (MRTK is een eenvoudige verwijzing in het
Packages/manifest.jsonbestand)
- Snellere compilatie
- Unity hoeft MRTK niet opnieuw te compileren tijdens het bouwen
- Afhankelijkheidsoplossing
- Vereiste MRTK-pakketten worden automatisch geïnstalleerd bij het opgeven van pakketten met afhankelijkheden
- Eenvoudig bijwerken naar nieuwe MRTK-versies
- De versie in het
Packages/manifest.jsonbestand wijzigen
- De versie in het
Voorbeelden van problemen zijn:
- MRTK is onveranderbaar
- Kan geen wijzigingen aanbrengen zonder dat ze tijdens pakketomzetting worden verwijderd
- MRTK biedt geen ondersteuning voor UPM-pakketten met Unity 2018.4
Basispakket
Het basispakket (com.microsoft.mixedreality.toolkit.foundation) vormt de basis van Mixed Reality Toolkit.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Core | Interface- en typedefinities, basisklassen, standaard shader. | |
| MRTK/Core/Providers | Platformonafhankelijke gegevensproviders | |
| Handen | Basisklasseondersteuning en -services voor handtracering. | |
| InputAnimation | Ondersteuning voor het opnemen van hoofdbewegingen en handtraceringsgegevens. | |
| InputSimulation | Ondersteuning voor in-editor simulatie van hand- en ooginvoer. | |
| ObjectMeshObserver | Waarnemer van ruimtelijk bewustzijn met behulp van een 3D-model als de gegevens. | |
| UnityInput | Algemene invoerapparaten (stick, muis, enzovoort) geïmplementeerd via de invoer-API van Unity. | |
| MRTK/Providers | Platformspecifieke gegevensproviders | |
| LeapMotion | Ondersteuning voor de UltraLeap Leap Motion-controller. | |
| OpenVR | Ondersteuning voor OpenVR-apparaten. | |
| Oculus | Ondersteuning voor Oculus-apparaten, zoals de Quest. | |
| UnityAR | (Experimenteel) Provider van camera-instellingen die MRTK-gebruik met mobiele AR-apparaten inschakelen. | |
| WindowsMixedReality | Ondersteuning voor Windows Mixed Reality apparaten, waaronder Microsoft HoloLens en insluitende headsets. | |
| Windows | Ondersteuning voor microsoft Windows-specifieke API's, bijvoorbeeld spraak en dicteren. | |
| XR SDK | (Experimenteel) Ondersteuning voor het nieuwe XR-framework van Unity in Unity 2019.3 en hoger. | |
| MRTK/SDK | ||
| Experimenteel | Experimentele functies, waaronder shaders, besturingselementen voor gebruikersinterfaces en afzonderlijke systeembeheerders. | |
| Functies | Functionaliteit die voortbouwt op het Foundation-pakket. | |
| Profielen | Standaardprofielen voor de Microsoft Mixed Reality Toolkit-systemen en -services. | |
| StandardAssets | Gemeenschappelijke activa; modellen, patronen, materialen, enzovoort. | |
| MRTK/Services | ||
| BoundarySystem | Systeem waarmee VR-grensondersteuning wordt geïmplementeerd. | |
| CameraSystem | Systeem dat cameraconfiguratie en -beheer implementeert. | |
| DiagnosticsSystem | Systeemialisatie in toepassingsdiagnose, bijvoorbeeld een visual profiler. | |
| InputSystem | Systeem dat ondersteuning biedt voor toegang tot en verwerking van gebruikersinvoer. | |
| SceneSystem | Systeem dat ondersteuning biedt voor toepassingen met meerdere scènes. | |
| SpatialAwarenessSystem | Systeem dat ondersteuning biedt voor het bewust zijn van de omgeving van de gebruiker. | |
| TeleportSystem | Systeem dat ondersteuning biedt voor teleporteren (verplaatsen over de ervaring in sprongen). |
Afhankelijkheden:
- Standaardassets (
com.microsoft.mixedreality.toolkit.standardassets)
Standaardassets
Het standaardassetpakket (com.microsoft.mixedreality.toolkit.standardassets) is een verzameling onderdelen die worden aanbevolen voor alle mixed reality-ervaringen, waaronder:
- MRTK Standard shader
- Basismaterialen met behulp van de MRTK Standard shader
- Audiobestanden
- Lettertypen
- Patronen
- Pictogrammen
Notitie
Om te voorkomen dat wijzigingen fouten veroorzaken op basis van assemblydefinities, worden de scripts die worden gebruikt om bepaalde functies van de MRTK Standard shader te beheren, niet opgenomen in het standaardassetpakket. Deze scripts vindt u in het basispakket in de MRTK/Core/Utilities/StandardShader map.
Afhankelijkheden: geen
Extensiepakketten
Het optionele uitbreidingspakket (com.microsoft.mixedreality.toolkit.extensions) bevat extra onderdelen die de functionaliteit van MRTK uitbreiden.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Extensies | ||
| HandPhysicsService | Service waarmee fysicaondersteuning wordt toegevoegd aan gelekte handen. | |
| LostTrackingService | Service die het bijhouden van verlies op Microsoft HoloLens apparaten vereenvoudigt. | |
| SceneTransitionService | Service die het toevoegen van soepele scèneovergangen vereenvoudigt. | |
| Voorbeelden~ | Een verborgen map (in de Unity Editor) die de voorbeeldscènes en assets bevat. |
Meer informatie over het gebruik van pakketten met voorbeeldprojecten vindt u in het artikel Mixed Reality Toolkit en Unity Package Manager.
Afhankelijkheden:
- Stichting (
com.microsoft.mixedreality.toolkit.foundation)
Pakket Hulpprogramma's
Het optionele hulpprogrammapakket (com.microsoft.mixedreality.toolkit.tools) bevat hulpprogramma's die handig zijn voor het maken van mixed reality-ervaringen. Over het algemeen zijn deze hulpprogramma's editoronderdelen en de bijbehorende code wordt niet verzonden als onderdeel van een toepassing.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Hulpprogramma's | ||
| BuildWindow | Hulpprogramma waarmee u het proces van het bouwen en implementeren van UWP-toepassingen kunt vereenvoudigen. | |
| DependencyWindow | Hulpprogramma waarmee een afhankelijkheidsgrafiek van assets in een project wordt gemaakt. | |
| ExtensionServiceCreator | Wizard voor hulp bij het maken van extensieservices. | |
| MigrationWindow | Hulpprogramma dat helpt bij het bijwerken van code die gebruikmaakt van afgeschafte MRTK-onderdelen. | |
| OptimizeWindow | Hulpprogramma voor het automatiseren van het configureren van een mixed reality-project voor de beste prestaties in Unity. | |
| ReserializeAssetsUtility | Biedt ondersteuning voor het wijzigen van het formaat van specifieke Unity-bestanden. | |
| RuntimeTools/Tools/ControllerMappingTool | Hulpprogramma waarmee ontwikkelaars snel Unity-toewijzingen voor hardwarecontrollers kunnen bepalen. | |
| ScreenshotUtility | Hiermee schakelt u het vastleggen van toepassingsinstallatiekopieën in de Unity-editor in. | |
| TextureCombinerWindow | Hulpprogramma voor het combineren van grafische patronen. | |
| Toolbox | Gebruikersinterface waarmee u MRTK UX-onderdelen gemakkelijk kunt detecteren en gebruiken. |
Afhankelijkheden:
- Stichting (
com.microsoft.mixedreality.toolkit.foundation)
Pakket hulpprogramma's testen
Het optionele pakket met testhulpprogramma's (com.microsoft.mixedreality.toolkit.testutilities) bevat een verzameling helperscripts waarmee ontwikkelaars eenvoudig afspeelmodustests kunnen maken. Deze hulpprogramma's zijn vooral handig voor ontwikkelaars die MRTK-onderdelen maken.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Tests | ||
| Testhulpprogramma's | Methoden om het maken van afspeelmodustests te vereenvoudigen, inclusief hulpprogramma's voor handsimulatie. |
Afhankelijkheden:
- Stichting (
com.microsoft.mixedreality.toolkit.foundation)
Voorbeeldenpakket
Het voorbeeldenpakket (com.microsoft.mixedreality.toolkit.examples) is gestructureerd zodat ontwikkelaars alleen de interessante voorbeelden kunnen importeren.
Meer informatie over het gebruik van pakketten met voorbeeldprojecten vindt u in het artikel Mixed Reality Toolkit en Unity Package Manager.
| Map | Onderdeel | Beschrijving |
|---|---|---|
| MRTK/Voorbeelden | ||
| Voorbeelden~ | Een verborgen map (in de Unity Editor) die de voorbeeldscènes en assets bevat. | |
| StandardAssets | Algemene assets die worden gedeeld door meerdere demoscènes. |
Afhankelijkheden:
- Stichting (
com.microsoft.mixedreality.toolkit.foundation) - Extensies (
com.microsoft.mixedreality.toolkit.extensions)