Delen via

Een nieuw OpenXR-project instellen met MRTK

De eenvoudigste manier om uw Unity-project in te stellen voor mixed reality is met de Mixed Reality Toolkit (MRTK). MRTK for Unity is een open-source, platformoverschrijdende ontwikkelkit die is ontworpen om het eenvoudig te maken om geweldige mixed reality-toepassingen te bouwen.

Infographic met enkele functies van de Mixed Reality Toolkit.

MRTK biedt een platformoverschrijdend invoersysteem, basisonderdelen en algemene bouwstenen voor ruimtelijke interacties. Het kan u helpen uw toepassingsontwikkeling te versnellen voor Microsoft HoloLens, Windows Mixed Reality immersive (VR) headsets en vele andere VR/AR-apparaten. Het project is gericht op het verminderen van toetredingsdrempels, zodat iedereen mixed reality-toepassingen kan bouwen en een bijdrage kan leveren aan de community naarmate we allemaal groeien.

MRTK ondersteunt een breed scala aan platforms, waaronder:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Windows Mixed Reality headsets

  • OpenVR-headsets (HTC Vive / Oculus Rift)

  • Ultraleap Hand Tracking

  • Android- en iOS-apparaten

Opmerking

U kunt ook een nieuw OpenXR-project instellen zonder MRTK.

Andere niet-OpenXR-configuratieopties die u kunt overwegen

Windows XR: Microsoft raadt het gebruik van de Windows XR-invoegtoepassing niet aan voor nieuwe projecten in Unity 2020. Gebruik in plaats daarvan de Mixed Reality OpenXR-invoegtoepassing. Als u Unity 2019 gebruikt en u AR Foundation 2.0 nodig hebt voor compatibiliteit met ARCore-/ARKit-apparaten, schakelt deze invoegtoepassing die ondersteuning in.

Verouderde XR:

Als u nog steeds unity 2019 of eerder gebruikt, raadt Microsoft aan de verouderde ingebouwde XR-ondersteuning te gebruiken.

Als u een nieuw project start, raden we u aan in plaats daarvan Unity 2020 te installeren en de Mixed Reality OpenXR-invoegtoepassing te gebruiken.

Aan de slag met OpenXR: een nieuw Unity-project maken

  1. Start de Unity Hub.

  2. Klik op het tabblad Projecten op Nieuw project.

    Schermopname van Unity Hub op het tabblad Projecten met de knop Nieuw project gemarkeerd.

  3. Klik op de vervolgkeuzelijst onder Nieuw project en selecteer de gewenste Editor versie.

    Schermopname van Unity Hub met de vervolgkeuzelijst Editor versie.

  4. Zorg ervoor dat de gekozen sjabloon 3D Core is.

  5. Voer in het vak Projectnaam een naam in voor uw project, bijvoorbeeld 'MRTK-zelfstudie'.

  6. Klik in het vak Locatie op het mappictogram en navigeer naar de map waarin u het project wilt opslaan en selecteer het. U kunt ook een nieuwe map maken.

    Schermopname van Unity Hub met 3D, Projectnaam, Locatie en Maken gemarkeerd.

  7. Klik op Project maken. Hiermee opent u uw project in Unity.

    Schermopname van uw project geopend in Unity.

Voorzichtigheid

Wanneer u in Windows werkt, is er een MAX_PATH limiet van 255 tekens. Unity wordt beïnvloed door deze limieten en kan mogelijk niet worden gecompileerd als een bestandspad langer is dan 255 tekens. Daarom raden we u aan uw Unity-project zo dicht mogelijk bij de hoofdmap van het station op te slaan.

Uw builddoel instellen

  1. Selecteer op de menubalk Instellingen voor bestandsopbouw>....

    Als u een app voor Windows Mixed Reality wilt bouwen, moet u een builddoel kiezen. De build-instellingen voor Universeel Windows-platform (UWP) zijn gericht op elk apparaat, inclusief insluitende headsets zoals de HP Reverb G2. Dit is de beste keuze als u bouwt voor de HoloLens 2. Als u zich echter richt op desktop-VR, raden we u aan het zelfstandige Linux-platform te gebruiken voor pc, Mac &.

  2. Voer een van de volgende handelingen uit:

    Als u zich richt op Desktop VR:

    • Behoud de pc, Mac & het zelfstandige Linux-platform dat standaard is geselecteerd in een nieuw Unity-project:

    Schermopname van het venster Build-instellingen dat is geopend in de Unity-editor met pc, Mac & Zelfstandig platform gemarkeerd

    Als u zich richt op de HoloLens 2:

    • Selecteer onder Platformde optie Universeel Windows-platform. Zorg ervoor dat de volgende instellingen actief zijn:

    Buildtype: D3D-project

    Doel-SDK-versie: laatst geïnstalleerd

    Minimale platformversie: 10.0.10240.0

    Visual Studio-versie: laatst geïnstalleerd

    Schermopname van het venster Build-instellingen dat is geopend in de Unity-editor met Universeel Windows-platform gemarkeerd.

  3. Klik op de knop Schakelen tussen platformen . Unity geeft een voortgangsbalk weer terwijl er wordt geschakeld tussen platforms.

  4. Nadat het switchplatformproces is voltooid, sluit u het venster Build-instellingen .

Het Mixed Reality Feature Tool downloaden en installeren

De Mixed Reality OpenXR-invoegtoepassing wordt geleverd in de vorm van een pakket voor Unity. De beste manier om functiepakketten te ontdekken, bij te werken en te importeren, is met het Mixed Reality Feature Tool. U kunt pakketten zoeken op naam of categorie, hun afhankelijkheden bekijken en voorgestelde wijzigingen in het manifestbestand van uw project bekijken voordat u het importeert.

  1. Download de meest recente versie van het Mixed Reality Feature Tool in het Microsoft Downloadcentrum.

  2. Nadat het downloaden is voltooid, navigeert u naar het uitvoerbare bestand MixedRealityFeatureTool.exe en gebruikt u dit bestand om het Mixed Reality Feature Tool te starten.

    Schermopname van MixedRealityFeatureTool openen.

De Mixed Reality Toolkit- en OpenXR-pakketten importeren

  1. Selecteer in het Mixed Reality Functiehulpprogramma de optie Start.

    Schermopname van het openingsscherm van het Mixed Reality Functiehulpprogramma.

  2. Selecteer de knop Bladeren (dit is de knop 'drie puntjes' in de onderstaande afbeelding), navigeer naar het project en open het.

    Uw project openen

    Opmerking

    Het vak Projectpad in het hulpprogramma moet een waarde bevatten, zodat er standaard een backslash (_) wordt ingevoegd.

    Nadat u een map hebt geselecteerd, controleert het hulpprogramma of het een geldige Unity-projectmap is.

    Schermopname van het scherm Projectpad Mixed Reality functie tool.

  3. Selecteer Functies detecteren.

    Opmerking: mogelijk moet u enkele seconden wachten terwijl het hulpprogramma de pakketten van de feeds vernieuwt.

  4. Op de pagina Functies ontdekken ziet u dat er een lijst met zes pakketgroepen is.

    De belangrijkste groepen pakketten in het functiehulpprogramma voor Mixed Reality

  5. Klik op de knop '+' links van Mixed Reality Toolkit (0 van 10) en selecteer vervolgens de nieuwste versie van Mixed Reality Toolkit Foundation.

    Opmerking

    Het Mixed Reality Toolkit Foundation-pakket is het enige pakket dat moet worden geïmporteerd en geconfigureerd om MRTK met uw project te kunnen gebruiken. Dit pakket bevat de kernonderdelen die nodig zijn om een mixed reality-toepassing te maken.

  6. Klik op de knop '+' links van platformondersteuning (0 van 5) en selecteer vervolgens de nieuwste versie van Mixed Reality OpenXR-invoegtoepassing.

    Schermopname van pakketselecties in het Mixed Reality Functiehulpprogramma.

  7. Nadat u uw selectie(s) hebt gemaakt, klikt u op Functies ophalen.

  8. Selecteer Valideren om de pakketten te valideren die u hebt geselecteerd. U ziet nu een dialoogvenster met de tekst Er zijn geen validatieproblemen gedetecteerd. Wanneer u dit doet, klikt u op OK.

  9. Op de pagina Functies importeren worden in de linkerkolom Functies de pakketten weergegeven die u zojuist hebt geselecteerd. In de rechterkolom , Vereiste afhankelijkheden, worden eventuele afhankelijkheden weergegeven. U kunt op de koppeling Details klikken voor een van deze items voor meer informatie.

  10. Wanneer u klaar bent om verder te gaan, selecteert u Importeren. Op de pagina Controleren en goedkeuren kunt u informatie over de pakketten bekijken.

  11. Selecteer Goedkeuren.

  12. Ga terug naar de Unity-Editor en klik op een leeg gebied in de gebruikersinterface. U ziet een voortgangsbalk die laat zien dat uw pakketten worden geïmporteerd.

Instellingen voor invoerback-end configureren

  1. Nadat Unity het pakket heeft geïmporteerd, verschijnt er een waarschuwing met de vraag of u de back-enden wilt inschakelen door de editor opnieuw op te starten. Selecteer Ja.

    Schermopname van de optie Voor opnieuw opstarten van Unity.

Het project voor de HoloLens 2 configureren via Projectvalidatie (MR OpenXR 1.6+)

Als u ontwikkelt voor bureaublad-VR, slaat u deze sectie over en gaat u naar Het project configureren voor bureaublad-VR.

  1. Klik op de menubalk op Mixed Reality > Projectvalidatie-instellingen > HoloLens 2 toepassing (UWP) om de validatieregels voor HoloLens 2 in te schakelen. Voor MR OpenXR-invoegtoepassingen vóór versie 1.9 is het menu-item beschikbaar Mixed Reality > Aanbevolen projectinstellingen voor project > toepassen voor HoloLens 2.
  2. Controleer in het venster voor projectvalidatie dat wordt weergegeven of u zich op het tabblad UWP-platform bevindt (aangegeven met het Windows-logo) en klik op Alles oplossen om de validatieproblemen op te lossen. Houd er rekening mee dat er problemen kunnen blijven nadat u op Alles oplossen hebt geklikt. Klik in dat geval opnieuw op Alles oplossen , negeer eventuele problemen die zijn gemarkeerd als 'scènespecifiek' (indien aanwezig) en doorloop de rest van de problemen (indien aanwezig) om te zien of er voorgestelde wijzigingen zijn die u wilt aanbrengen.
  3. Het project is op dit moment bijna klaar voor HoloLens 2 implementatie. Ga verder met Player-instellingen configureren voor de volgende stap.

Het project voor de HoloLens 2 handmatig configureren

Als u ontwikkelt voor bureaublad-VR, slaat u deze sectie over en gaat u naar Het project configureren voor bureaublad-VR.

  1. Zorg ervoor dat het venster Projectinstellingen is geopend. Zo niet, selecteert uprojectinstellingenbewerken> op de menubalk.

  2. Controleer in het venster Projectinstellingen of u zich op de pagina Beheer van XR-invoegtoepassing bevindt en op het tabblad Universeel Windows-platform.

    Schermopname van het venster Projectinstellingen geopend op de pagina XR-invoegtoepassingsbeheer en Universeel Windows-platform tabblad.

  3. Zorg ervoor dat XR initialiseren bij opstarten is geselecteerd en klik vervolgens onder Invoegtoepassingsproviders op OpenXR.

    Schermopname van het venster Projectinstellingen in de Universeel Windows-platform, met XR initialiseren bij opstarten geselecteerd en de OpenXR-invoegtoepassing gemarkeerd.

  4. De OpenXR-invoegtoepassing wordt geladen en vervolgens worden er meerdere items weergegeven onder OpenXR. Selecteer Microsoft HoloLens functiegroep.

    Schermopname van het venster Projectinstellingen met de OpenXR-invoegtoepassing en de Microsoft HoloLens functiegroep gemarkeerd.

Houd er rekening mee dat er een gele waarschuwingsdriehoek naast OpenXR staat. Dit geeft aan dat u incompatibele instellingen hebt die moeten worden opgelost. Als u wilt zien hoe u dit kunt oplossen, slaat u de volgende sectie over het configureren voor VR over en gaat u verder met de volgende sectie, Incompatibele instellingen oplossen.

Het project configureren voor bureaublad-VR via Projectvalidatie (MR OpenXR 1.9+)

  1. Klik op de menubalk op Mixed Reality > Projectvalidatie-instellingen > Win32-toepassing (zelfstandig) om de validatieregels voor een XR-bureaublad-app in te schakelen.
  2. Controleer in het venster projectvalidatie dat wordt weergegeven of u zich op het tabblad Zelfstandig platform bevindt en klik op Alles oplossen om de validatieproblemen op te lossen. Houd er rekening mee dat er problemen kunnen blijven nadat u op Alles oplossen hebt geklikt. Klik in dat geval opnieuw op Alles oplossen , negeer eventuele problemen die zijn gemarkeerd als 'scènespecifiek' (indien aanwezig) en doorloop de rest van de problemen (indien aanwezig) om te zien of er voorgestelde wijzigingen zijn die u wilt aanbrengen.

Het project voor desktop VR handmatig configureren

  1. Zorg ervoor dat het venster Projectinstellingen is geopend. Zo niet, ga dan naar de menubalk en selecteerProjectinstellingen bewerken>.

  2. Controleer in het venster Projectinstellingen of u zich op de pagina Beheer van XR-invoegtoepassing bevindt en op het tabblad Pc, Mac & Zelfstandig linux-tabblad .

    Schermopname van het venster Projectinstellingen dat wordt geopend op de pagina XR-invoegtoepassingsbeheer en pc, Mac & tabblad Zelfstandig linux.

  3. Zorg ervoor dat XR initialiseren bij opstarten is geselecteerd en klik vervolgens onder Invoegtoepassingsproviders op OpenXR.

    Schermopname van het venster Projectinstellingen, in het tabblad Pc, Mac & zelfstandige Linux- met Initialize XR bij opstarten geselecteerd en de OpenXR-invoegtoepassing gemarkeerd.

  4. De OpenXR-invoegtoepassing wordt geladen en vervolgens worden er twee items weergegeven onder OpenXR. Selecteer de eerste Windows Mixed Reality functiegroep.

    Schermopname van het venster Projectinstellingen met de OpenXR-invoegtoepassing en Windows Mixed Reality functiegroep gemarkeerd.

Houd er rekening mee dat er nu een gele waarschuwingsdriehoek naast OpenXR staat. Dit geeft aan dat u incompatibele instellingen hebt die moeten worden opgelost. Als u wilt zien hoe u dit kunt oplossen, gaat u verder met de volgende sectie, Incompatibele instellingen oplossen.

Incompatibele instellingen oplossen

Belangrijk

De afbeeldingen in deze sectie bevatten de opties op het tabblad Universeel Windows-platform. De instructies zijn echter hetzelfde voor het tabblad Bureaublad-VR, behalve waar vermeld.

  1. Plaats de muisaanwijzer op de gele waarschuwingsdriehoek naast OpenXR, lees het bericht in de pop-up en selecteer vervolgens het driehoekje.

    Schermopname van de waarschuwing over incompatibele instellingen.

  2. In het venster OpenXR-projectvalidatie worden verschillende problemen vermeld. Selecteer de knop Alles herstellen . OPMERKING: Deze lijst kan er anders uitzien, afhankelijk van het tabblad waarin u zich bevindt.

    Schermopname van de knop Alles herstellen in het venster OpenXR-projectvalidatie.

  3. Eén probleem blijft bestaan en geeft aan dat u ten minste één interactieprofiel moet toevoegen. Klik hiervoor op Bewerken. Hiermee gaat u naar de instellingen voor de OpenXR-invoegtoepassing in het venster Projectinstellingen .

    Schermopname van het venster Projectinstellingen met de OpenXR-instellingen weergegeven.

  4. Noteer onder Interactieprofielen de knop met het plusteken (+).

    Schermopname van de knop Interactieprofiel toevoegen.

  5. Klik drie keer op de knop, waarbij u telkens een ander profiel kiest:

    Interactieprofiel voor ogen

    Microsoft Hand Interaction Profile

    Microsoft Motion Controller-profiel

    Schermopname van interactieprofielen die moeten worden toegevoegd.

    Als het Eye Gaze Interaction Profile of een ander profiel wordt weergegeven met een gele driehoek ernaast, selecteert u de driehoek en klikt u vervolgens in het venster OpenXR-projectvalidatie op de knop Herstellen . Wanneer u klaar bent, sluit u het venster OpenXR-projectvalidatie .

    Schermopname van de knop Fix voor het interactieprofiel Eye Gaze.

  6. Controleer in het venster Projectinstellingen onder OpenXR-functiegroepen of het volgende is geselecteerd:

    Als u zich op het tabblad Bureaublad-VR bevindt:

    Windows Mixed Reality

    Handtracering

    Bewegingscontrollermodel

    Schermopname van de OpenXR-functiegroepen voor het tabblad Bureaublad-VR.

    Als u zich op het tabblad Universeel Windows-platform bevindt:

    Microsoft HoloLens

    Handtracering

    Bewegingscontrollermodel

    Schermopname van geselecteerde functies voor OpenXR.

  7. Klik op de vervolgkeuzelijst Diepteverzendingsmodus en selecteer diepte 16 bits.

    Schermopname van diepte 16 bits geselecteerd voor diepteinzendingsmodus.

    Tip

    Het verlagen van de diepte-indeling naar 16-bits is optioneel, maar het kan de grafische prestaties in uw project verbeteren. Zie Dieptebuffer delen (HoloLens) voor meer informatie.

    Opmerking

    De instelling Rendermodus , die zich net boven de modus Diepteinzending bevindt, is standaard ingesteld op Single Pass Instanced. In mixed reality-apps wordt de scène twee keer weergegeven: één keer voor elk oog. Het resultaat is 'stereoscopisch zicht'. Dit verdubbelt de hoeveelheid benodigde computing, dus het is belangrijk om het meest efficiënte renderingpad in Unity te selecteren om zowel CPU- als GPU-tijd te besparen. Single Pass instanced rendering is hier de beste keuze. U wordt aangeraden deze standaard in te schakelen voor elk project. Zie de Unity-documentatie voor meer informatie hierover.

Instellingen voor Player configureren

  1. Selecteer In de linkerkolom van het venster Projectinstellingende optie Player.

  2. Houd er rekening mee dat in het venster Player het vak Productnaam al is ingevuld. Dit is afkomstig uit de naam van uw project en wordt de naam die wordt weergegeven in het menu Start van HoloLens.

    Schermopname van Publicatie-instellingen voor Unity met het vak Projectnaam ingevuld.

    Tip

    Als u de app gemakkelijker kunt vinden tijdens de ontwikkeling, voegt u een onderstrepingsteken toe vóór de naam om deze boven aan een lijst te sorteren.

  3. Klik op de vervolgkeuzelijst Publicatie-instellingen en voer in het veld Pakketnaam een geschikte naam in.

    Schermopname van Publicatie-instellingen voor Unity met het vak pakketnaam ingevuld.

    Opmerking

    De pakketnaam is de unieke id voor de app. Als u wilt voorkomen dat eerder geïnstalleerde versies van de app met dezelfde naam worden overschreven, moet u deze id wijzigen voordat u de app implementeert.

  4. Sluit het venster Projectinstellingen .

U bent nu klaar om te gaan ontwikkelen met OpenXR in Unity.

Unity-voorbeeldprojecten

Bekijk de OpenXR Mixed Reality opslagplaats voor voorbeelden van Unity-projecten waarin wordt beschreven hoe u Unity-toepassingen bouwt voor HoloLens 2 of Mixed Reality headsets met behulp van de Mixed Reality OpenXR-invoegtoepassing.

Zie ook

  • Last updated on