Een nieuw OpenXR-project instellen zonder MRTK

  • Artikel

Hoewel Microsoft en de community open source hulpprogramma's hebben gemaakt, zoals de MRTK (Mixed Reality Toolkit), waarmee uw omgeving automatisch wordt ingesteld voor mixed reality, willen sommige ontwikkelaars mogelijk hun ervaringen vanaf de basis opbouwen.

Andere niet-OpenXR-configuratieopties om te 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 echter 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 unity 2019 of eerder gebruikt, raadt Microsoft aan om de verouderde ingebouwde XR-ondersteuning te gebruiken. Hoewel de Windows XR-invoegtoepassing functioneel is 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 Editorversie.

  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, 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 voor het>samenstellen van bestanden... .

    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 echter op desktop VR bent gericht, raden we u aan het zelfstandige platform voor pc, Mac & Linux te gebruiken.

  2. Voer een van de volgende handelingen uit:

    Als u zich richt op Desktop VR:

    • Behoud het zelfstandige Platform voor pc, Mac & Linux , 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 deze van platform wisselt.

  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 nieuwste versie van het Mixed Reality Feature Tool van 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 OpenXR-invoegtoepassing importeren

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

    Schermopname van het openingsscherm van het Mixed Reality Feature Tool.

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

    Open uw project

    Notitie

    Het vak Projectpad in het hulpprogramma moet een bepaalde 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 van het Mixed Reality-functiehulpmiddel.

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

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

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

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

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

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

  10. Selecteer Goedkeuren.

  11. Ga terug naar de Unity-editor en klik op een leeg gebied in de gebruikersinterface. U ziet een voortgangsbalk die laat zien dat het pakket wordt 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 desktop VR, slaat u deze sectie over en gaat u naar Het project configureren voor bureaublad-VR.

  1. Controleer of 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 geopend op de pagina XR-invoegtoepassingsbeheer en Universeel Windows-platform tabblad.

  3. Zorg ervoor dat XR bij opstarten initialiseren is geselecteerd en klik vervolgens onder Providers van invoegtoepassingen 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 er worden vervolgens 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 niet-compatibele instellingen hebt die moeten worden opgelost. Als u wilt weten 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 desktop VR via Projectvalidatie (MR OpenXR 1.9+)

  1. Klik op de menubalk op Mixed Reality > Project validatie-instellingen > Win32-toepassing (zelfstandig) om de validatieregels voor een XR-bureaublad-app in te schakelen.
  2. Controleer in het venster voor 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 mogelijk problemen blijven bestaan 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. Controleer of het venster Projectinstellingen is geopend. Als dat niet het antwoord is, gaat u naar de menubalk en selecteert uProjectinstellingen bewerken>.

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

    Schermopname van het venster Projectinstellingen dat wordt geopend op de beheerpagina van de XR-invoegtoepassing en de pc, Mac & tabblad Zelfstandig Linux.

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

    Schermopname van het venster Projectinstellingen op 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 waarin de OpenXR-invoegtoepassing en Windows Mixed Reality functiegroep zijn gemarkeerd.

Er staat nu een gele waarschuwingsdriehoek naast OpenXR. Dit geeft aan dat u niet-compatibele 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 Desktop VR, behalve waar vermeld.

  1. Beweeg de cursor over 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. Er blijft één probleem bestaan en u moet ten minste één interactieprofiel 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 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 staren

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

    Als u zich op het tabblad Vr op het bureaublad 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 Modus diepteverzending en selecteer vervolgens Diepte 16-bits.

    Schermopname van Depth 16 Bit geselecteerd voor Depth Submission Mode.

    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.

    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 linkerkolom van het venster Projectinstellingen.

  2. Houd er rekening mee dat in het venster Player het vak Productnaam al is ingevuld. Dit is afkomstig van uw projectnaam 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

    Om de app gemakkelijker te 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 met Voorbeelden van OpenXR Mixed Reality voor voorbeeldprojecten voor 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