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.

Pakage foundationMRTK 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).

HandInteractionExample scène

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.json bestand)
  • 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.json bestand wijzigen

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)

Zie ook