Oefening - Resources importeren en configureren

  • 10 minuten

Het hulpprogramma mixed reality-functie installeren

Als u de Mixed Reality Toolkit in uw project wilt importeren, gebruiken we het Hulpprogramma voor mixed reality-functies, waarmee ontwikkelaars functiepakketten kunnen detecteren, bijwerken en importeren. U kunt pakketten zoeken op naam of categorie, hun afhankelijkheden bekijken en voorgestelde wijzigingen weergeven in het manifestbestand van uw project voordat u importeert.

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

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

    Notitie

    Voordat u het Mixed Reality Feature Tool kunt uitvoeren, moet u mogelijk de .NET 6.0-runtime installeren.

Het MRTK Unity Foundation-pakket importeren

  1. Selecteer Start in het hulpprogramma voor mixed reality-functies.

    Screenshot of the Mixed Reality Feature Tool opening screen.

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

    Screenshot of the Select Project screen.

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

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  3. Selecteer Functies ontdekken.

    Notitie

    Mogelijk moet u enkele seconden wachten terwijl het hulpprogramma de pakketten van de feeds vernieuwt.

  4. Op de pagina Onderdelen ontdekken ziet u dat er een lijst met beschikbare pakketgroepen is.

    Screenshot of the main groups of packages in the Mixed Reality Feature Tool.

  5. Selecteer de + knop links van Platform Support (0 van 5) en selecteer vervolgens de nieuwste versie van de Mixed Reality OpenXR-invoegtoepassing.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Selecteer de knop Alles selecteren rechts van MRTK3 , zodat alle functies zijn geselecteerd.

    Screenshot of selecting all feature of MRTK3.

    Notitie

    Als u pakketten ziet die zijn gemarkeerd als afgeschaft, moet u ze verwijderen en ervoor zorgen dat Instellingen >> afgeschafte pakketten voor onderdelen weergeven is uitgeschakeld.

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

  8. Selecteer Valideren om de pakketten te valideren die u hebt geselecteerd. Er wordt een dialoogvenster weergegeven met de mededeling dat er geen validatieproblemen zijn gedetecteerd. Wanneer u dit doet, selecteert u OK.

  9. Op de pagina Functies importeren, de kolom aan de linkerkant, Functies, worden de pakketten weergegeven die u hebt geselecteerd. In de rechterkolom, Vereiste afhankelijkheden, worden eventuele afhankelijkheden weergegeven. U kunt de koppeling Details voor een van deze items selecteren voor meer informatie.

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

  11. Selecteer Goedkeuren.

  12. Selecteer Afsluiten.

  13. Ga terug naar de Unity-editor en selecteer een leeg gebied in de gebruikersinterface. U ziet een voortgangsbalk waarin wordt weergegeven dat uw pakketten worden geïmporteerd.

Het Unity-project configureren

  1. Nadat Unity de pakketten heeft geïmporteerd, wordt er een waarschuwing weergegeven waarin u wordt gevraagd of u de back-ends wilt inschakelen door de editor opnieuw te starten. Selecteer Ja.

    Screenshot of Unity Restart Option.

  2. Unity vraagt u over het bijwerken van methoden in de XR InteractionLayerMask, selecteer de knop I Made a Backup, Go Ahead! en wacht tot Unity opnieuw is opgestart.

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. Selecteer in de menubalk de optie Mixed Reality>Project>Aanbevolen projectinstellingen toepassen voor HoloLens.

  4. Selecteer In de menubalk Project bewerken>Instellingen.... Selecteer XR-invoegtoepassingsbeheer. Zorg ervoor dat XRbij opstarten is geselecteerd en selecteer vervolgens onder Invoegtoepassingsproviders de optie XR openen.

    Screenshot of Initialize XR on Startup.

  5. De OpenXR-invoegtoepassing wordt geladen en vervolgens worden er twee items weergegeven onder OpenXR. Selecteer de eerste, microsoft HoloLens-functiegroep. Selecteer het gele uitroepteken.

    Screenshot of Open XR option.

  6. Selecteer Alles herstellen.

    Screenshot of Fix All.

    Sommige waarschuwingen blijven mogelijk behouden. Negeer ze voorlopig.

  7. Selecteer OpenXR onder XR-invoegtoepassingsbeheer.

  8. Voeg onder Interactieprofielen Microsoft Hand Interaction en Eye Gaze Interaction-profiel toe als deze nog niet zijn toegevoegd.

    Screenshot of Add Interaction Profiles.

  9. Zorg ervoor dat Microsoft Hololens aan de linkerkant is geselecteerd en dat Handtracking, Mixed Reality Features en Motion Controller Model aan de rechterkant zijn geselecteerd.

  10. Selecteer het waarschuwingsteken naast Eye Gaze Interaction Profile om het venster Projectvalidatie terug te brengen. Zorg ervoor dat u zich op het tabblad UWP-platform bevindt (het tabblad geeft het Windows-logo weer) en selecteer Alles oplossen om de validatieproblemen op te lossen. Houd er rekening mee dat er mogelijk problemen blijven nadat u Alles oplossen hebt geselecteerd. In dat geval selecteert u Alles herstellen, negeert u eventuele problemen die specifiek zijn voor scènes en leest u de aanbevelingen voor de resterende problemen (indien van toepassing) en voert u de gewenste wijzigingen aan.

  11. Selecteer onder Project Instellingen MRTK3 en controleer of er een geldig profiel is. Als er geen is, zoekt u naar MRTKProfile in de pakketten van het project (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) en wijst u deze toe aan het profiel.

    Screenshot of MRTK profile.

Projectinstellingen configureren

  1. Selecteer Project bewerken>in de menubalk Instellingen.

  2. Selecteer Player in de linkerkolom van het project Instellingen venster.

  3. Houd er rekening mee dat in het venster Player de productnaam 'MRTK Tutorial' is. Dit is afkomstig van de projectnaam en wordt de naam weergegeven in de HoloLens-Startmenu.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    Fooi

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

  4. Selecteer de vervolgkeuzelijst Publiceren Instellingen en voer vervolgens in het veld Pakketnaam een geschikte naam in, bijvoorbeeld MRTK-Tutorials-Getting-Started:

    Screenshot of Unity Publishing Settings with the package name box filled in.

    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.

  5. Sluit het venster Project Instellingen.

De scène maken en MRTK configureren

  1. Selecteer Bestand>nieuwe scène in de menubalk. Selecteer de optie Basic (ingebouwd) en vervolgens Maken.

  2. Navigeer in het venster Project naar de map Prefabs Packages> MRTK Input>Assets.> Sleep de prefab MRTK XR Rig naar de scènehiërarchie.

    Screenshot of the adding MRTK XR Rig in the Inspector.

  3. Verwijder het object Main Camera game omdat MRTK XR Rig game object al een camera bevat.

    Screenshot of the Mixed Reality Toolkit in the Inspector.

  4. Voeg de MRTK Input Simulator (Pakketten>MRTK Input>Simulation>Prefabs) prefabs toe aan uw scène.

    Notitie

    Deze stap is optioneel, maar vereist voor simulaties in de editor.

    Screenshot of the input simulator.

  5. Selecteer Bestand>opslaan als...in de menubalk.

  6. Navigeer naar de map Activascènes>, geef uw project een naam en sla het project op.