Delen via

Een nieuw OpenXR-project instellen met MRTK

  • Artikel

De eenvoudigste manier om uw Unity-project in te stellen voor mixed reality is met de MRTK (Mixed Reality Toolkit). MRTK for Unity is een opensource,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 voor Microsoft HoloLens, Windows Mixed Reality immersive (VR)-headsets en vele andere VR/AR-apparaten te versnellen. Het project is gericht op het verminderen van barrières voor toegang, 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

Notitie

We hebben onlangs MRTK3 geïntroduceerd, de derde generatie van Microsoft Mixed Reality Toolkit voor Unity, gebouwd op het XR-beheersysteem en XR Interaction Toolkit van Unity, met betere ondersteuning voor verschillende OpenXR-compatibele apparaten en een nieuwe ontwerptaal. Zie de MRTK3-documentatie voor meer informatie.

Notitie

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

Andere niet-OpenXR-configuratieopties die u moet 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, maakt deze invoegtoepassing die ondersteuning mogelijk.

Belangrijk

Het gebruik van deze invoegtoepassing in Unity 2019 is niet compatibel met Azure Spatial Anchors.

Verouderde XR:

Als u nog steeds werkt met Unity 2019 of eerder, raadt Microsoft aan gebruik te maken van de verouderde ingebouwde XR-ondersteuning. Hoewel de Windows XR-invoegtoepassing werkt in Unity 2019, raden we deze niet aan omdat deze niet compatibel is met Azure Spatial Anchors in Unity 2019.

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 vervolgens de gewenste editorversie.

    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 dat is geopend in Unity.

Waarschuwing

Bij het werken met Windows geldt een MAX_PATH-limiet van 255 tekens. Unity wordt beïnvloed door deze limieten en kan mogelijk niet compileren 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 in de menubalk Instellingen voorbestandsbuilding>....

    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 immersive headsets zoals de HP Reverb G2. Dit is de beste keuze als u bouwt voor de HoloLens 2. Als u echter gericht bent op desktop VR, raden we u aan het zelfstandige platform van de pc, Mac & Linux te gebruiken.

  2. Voer een van de volgende handelingen uit:

    Als u zich richt op Desktop VR:

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

    Schermopname van het venster Build Settings 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 Settings geopend in de Unity-editor met Universeel Windows-platform gemarkeerd.

  3. Klik op de knop Ander platform . 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 Plugin 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 weergeven voordat u ze importeert.

  1. Download de nieuwste versie van het Mixed Reality Feature Tool uit het Microsoft Downloadcentrum.

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

    Schermopname van het openen van MixedRealityFeatureTool.

De Mixed Reality Toolkit- en OpenXR-pakketten importeren

  1. Selecteer Start in het Mixed Reality-functieprogramma.

    Schermopname van het scherm Mixed Reality Functiehulpmiddel openen.

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

    Open uw project

    Notitie

    Het vak Projectpad in het hulpprogramma moet een waarde bevatten, zodat 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 van Mixed Reality functie Tool.

  3. Selecteer Functies ontdekken.

    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 functiehulpmiddel 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.

    Notitie

    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 vereist zijn voor het maken van een toepassing met mixed reality.

  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 functiehulpprogramma Mixed Reality.

  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-ends wilt inschakelen door de editor opnieuw 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 in 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 beschikbare menu-item Mixed Reality > Aanbevolen > projectinstellingen voor project toepassen voor HoloLens 2.
  2. Controleer in het projectvalidatievenster 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 van toepassing) 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 naar Instellingen voor Speler 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 u projectinstellingen bewerken> in 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 dat wordt 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 projectvalidatievenster 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 van toepassing) 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 selecteerProjectinstellingenbewerken>.

  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 de pc, Mac & tabblad Zelfstandig Linux, met XR initialiseren 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 aangegeven.

  1. Beweeg de muisaanwijzer over het gele waarschuwingsdriehoekje naast OpenXR, lees het bericht in de pop-up en selecteer vervolgens het driehoekje.

    Schermopname van 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 vertelt u 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. Let onder Interactieprofielen op 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:

    Eye Gaze Interaction Profile

    Microsoft-profiel voor handinteractie

    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. Zorg ervoor dat in het venster Projectinstellingen onder OpenXR-functiegroepen het volgende is geselecteerd:

    Als u zich op het tabblad Bureaublad-VR bevindt:

    Windows Mixed Reality

    Handtracering

    Motion Controller-model

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

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

    Microsoft HoloLens

    Handtracering

    Motion Controller-model

    Schermopname van geselecteerde functies voor OpenXR.

  7. Klik op de vervolgkeuzelijst Diepteverzendingsmodus en selecteer vervolgens Diepte 16-bits.

    Schermopname van Depth 16 Bit geselecteerd voor Depth Submission Mode.

    Tip

    Het verminderen 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.

    Notitie

    De instelling Rendermodus , die zich net boven Diepteinzendingsmodus 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 Speler configureren

  1. Selecteer Player in de kolom aan de linkerkant van het venster Projectinstellingen.

  2. Houd er rekening mee dat in het venster Player het vak Productnaam al is ingevuld. Dit wordt overgenomen uit de naam van uw project en is 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.

    Notitie

    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 Opslagplaats voor OpenXR Mixed Reality-voorbeelden voor voorbeeldprojecten van Unity waarin wordt uitgelegd hoe u Unity-toepassingen bouwt voor HoloLens 2- of Mixed Reality-headsets met behulp van de Mixed Reality OpenXR-invoegtoepassing.

Zie ook