Uw Unreal-project instellen

Het is raadzaam om Versie 4.25 of hoger van Unreal Engine te installeren om optimaal te profiteren van de ingebouwde HoloLens ondersteuning.

Ga naar het tabblad Bibliotheek in het Epic Games Launcher, selecteer de vervolgkeuzepijl naast Starten en klik op Opties. Selecteer onder Doelplatformen de HoloLens 2 klik op Toepassen. Installatieoptie voor Unreal HoloLens 2

Import Mixed Reality Toolkit for Unreal

MRTK

Mixed Reality Toolkit (MRTK) is een open source platformoverschrijdende development kit voor mixed reality toepassingen. MRTK biedt een platformoverschrijdend invoersysteem, basisonderdelen en algemene bouwstenen voor ruimtelijke interacties. De toolkit is bedoeld om de ontwikkeling te versnellen van toepassingen die zijn gericht op Microsoft HoloLens, Windows Mixed Reality immersive (VR)-headsets en het OpenVR-platform.

Als u nog geen project mixed reality hebt, volgt u de eerste drie secties van de HoloLens 2 Aan de slag zelfstudies om een project gereed te maken voor de MRTK.

Introductie van de MRTK Hub voor Unreal

U wordt aangeraden de MRTK Hub te gebruiken om MRTK-invoegvoegingen te verkrijgen. Het is een nieuwe manier voor ontwikkelaars om Microsoft Mixed Reality te ontdekken en bij te werken en ze toe te voegen aan hun Unreal-projecten. U kunt invoegingen bekijken, hun afhankelijkheden bekijken en deze installeren in uw project zonder de Editor van Unreal te verlaten.

  • Ontdek nieuwe Microsoft Mixed Reality en installeer deze en hun afhankelijkheden in uw Unreal-project.
  • Houd uw Microsoft Mixed Reality-invoegingen up-to-date.
  • Verwijder Microsoft Mixed Reality-invoegs uit uw project als u deze niet meer nodig hebt.

Notitie

De MRTK Hub voor Unreal is alleen beschikbaar voor Unreal Engine versie 4.26 of hoger. Voor Unreal Engine versie 4.25 kunt u MRTK-invoegvoegingen downloaden van de Marketplace of GitHub voor Unreal Engine, zoals beschreven in de Aan de slag sectie.

De MRTK Hub installeren

Download de invoeg-app van de Marketplace voor Unreal Engine,open uw project en schakel de invoeginvoeging in vanuit de Mixed Reality sectie van het menu Invoegvoegingen. Start de editor opnieuw wanneer u daarom wordt gevraagd.

De MRTK Hub-invoeging inschakelen

Zodra de invoeg-app is ingeschakeld voor uw project, hebt u via de werkbalkknop toegang tot de hub.

Het venster MRTK Hub openen

De mixed reality installeren

Als u een invoeg-app wilt installeren met behulp van de hub, selecteert u de invoeginvoeging die u aan uw project wilt toevoegen en drukt u vervolgens op de knop Installeren. Als u de invoeg-app wilt downloaden, controleert u of er geen conflicten zijn in het vak Problemen en drukt u op Bevestigen. Zodra de invoeg-app is gedownload, wordt u gevraagd om de editor opnieuw op te starten. Helaas kunnen we de editor niet automatisch opnieuw starten; soms wordt het nieuwe editor-exemplaar start voordat de installatie is voltooid.

Een invoeg-app installeren met behulp van de MRTK Hub

Nadat u de editor hebt gesloten, ziet u dat er een opdrachtprompt wordt weergegeven met een voortgangsbalk voor het uitpakken van de gedownloade invoeg-app. Er wordt één opdrachtprompt weergegeven voor elke invoeging die wordt geïnstalleerd. Nadat het uitpakken is voltooid, kunt u de editor opnieuw openen en doorgaan met mixed reality ontwikkeltraject.

MRTK Hub voor het uitpakken van een invoeg-app via een opdrachtprompt

Belangrijk

Zodra de invoegvoegcode is geïnstalleerd, moet deze worden ingecheckt bij broncodebeheer, net als elke andere invoegcode op projectniveau.

Invoeg mixed reality bijwerken

Als u een invoeg-app wilt bijwerken met behulp van de hub, selecteert u de invoeginvoeging die u wilt bijwerken in de lijst en drukt u op de knop Installeren. Als u de bijgewerkte invoegvoeging wilt downloaden, controleert u of er geen conflicten zijn in het vak Problemen en drukt u op Bevestigen. U wordt gevraagd de editor opnieuw te starten om de update te voltooien. Updates van de invoeg-app worden uitgevoerd tijdens het opstarten van de editor, zodat u niet hoeft te wachten tot het uitpakken is voltooid voordat u de editor opnieuw opent.

Een invoeg-app bijwerken via de MRTK Hub

Invoeg mixed reality verwijderen

Als u een invoeg-app wilt verwijderen met behulp van de hub, selecteert u de invoegvoeginstallatie die u wilt verwijderen en selecteert u vervolgens de versie die u hebt geïnstalleerd in de vervolgkeuzekeuze. Als u de invoeg-app wilt verwijderen, controleert u of er geen conflicten zijn in het vak Problemen en drukt u op Bevestigen. U wordt gevraagd de editor opnieuw te starten om het verwijderen te voltooien.

Een invoeg-app verwijderen via de MRTK Hub

Wijzigingen controleren en incompatibiliteit detecteren

U kunt de exacte wijzigingen die aan uw project worden aangebracht, bekijken in de onderste sectie van het venster van de hub. Hier ziet u de invoegvoegingen die worden toegevoegd aan of verwijderd uit uw project, naast mogelijke incompatibiliteiten die problemen kunnen veroorzaken wanneer de wijzigingen zijn aangebracht.

Notitie

In de lijst Problemen worden incompatibiliteiten weergegeven in de versies van de Versie van de Unreal-engine en de afhankelijkheidsversie van de invoeg-invoeglijkheid, maar deze oplossing wordt niet automatisch opgelost of er worden geen oplossingen voor suggesties voor problemen weergegeven.

Poging om een incompatibele invoeging te installeren

Notitie

Als u MRTK niet wilt gebruiken voor Unreal, moet u alle interacties en gedragingen zelf als script uitvoeren.