Welkom bij het hulpprogramma Mixed Reality functie
Belangrijk
Het hulpprogramma Mixed Reality functie is momenteel alleen beschikbaar voor Unity. Als u ontwikkelt in Unreal, raadpleegt u de installatiedocumentatie voor hulpprogramma's .
Het Mixed Reality Feature Tool is een nieuwe manier voor ontwikkelaars om Mixed Reality functiepakketten te ontdekken, bij te werken en toe te voegen aan Unity-projecten. U kunt pakketten zoeken op naam of categorie, hun afhankelijkheden bekijken en zelfs voorgestelde wijzigingen in het manifestbestand van uw projecten bekijken voordat u het importeert. Als u nog nooit met een manifestbestand hebt gewerkt, is het een JSON-bestand dat al uw projectpakketten bevat. Zodra u de gewenste pakketten hebt gevalideerd, downloadt het hulpprogramma Mixed Reality functie deze in het project van uw keuze.
Systeemvereisten
Voordat u het hulpprogramma Mixed Reality functie kunt uitvoeren, hebt u het volgende nodig:
- Een pc met Windows 10 of 11 met een actieve internetverbinding
Notitie
Als de pc zich in een netwerk bevindt dat wordt beheerd door een organisatie, moet u ervoor zorgen dat toegang tot de volgende URL's is toegestaan:
- https://aka.ms/*
- https://learn.microsoft.com/*
- https://pkgs.dev.azure.com/*
- https://feeds.dev.azure.com/*
- https://mixedrealitycloud.pkgs.visualstudio.com/* (alleen voor speciale early access-gebruikers)
Downloaden
Zodra u uw omgeving hebt ingesteld:
- Download de nieuwste versie van het Mixed Reality Feature Tool uit het Microsoft Downloadcentrum.
- Wanneer het downloaden is voltooid, pakt u het bestand uit en slaat u het op uw bureaublad op
- U wordt aangeraden een snelkoppeling naar het uitvoerbare bestand te maken voor snellere toegang
Notitie
Als u de Unity Package Manager nog niet hebt gebruikt, volgt u onze UPM-instructies.
Wijzigingen in deze release
Versie 1.0.2209.0-Preview bevat de volgende verbeteringen:
- De optie Preview-functies weergeven is toegevoegd aan de weergave Functies ontdekken
- Bijgewerkt naar .NET 6
- De app en .NET 6-runtime samengevoegd tot één uitvoerbaar bestand voor eenvoudigere distributie
- Er is een probleem opgelost waarbij een prompt voor het downgraden van bestaande pakketversies wordt weergegeven wanneer dit niet nodig is
1. Aan de slag
Start het Mixed Reality Feature Tool vanuit het uitvoerbare bestand, waarin de startpagina wordt weergegeven bij de eerste start:
Vanaf de startpagina kunt u het volgende doen:
- Hulpprogramma-instellingen configureren met behulp van de knop tandwielpictogram
- Gebruik de vraagtekenknop om de standaardwebbrowser te starten en onze documentatie weer te geven
- Selecteer Start om te beginnen met het detecteren van functiepakketten
2. Uw Unity-project selecteren
Om ervoor te zorgen dat alle gedetecteerde functies worden ondersteund in de versie van Unity van uw project, is de eerste stap het Mixed Reality functiehulpprogramma naar uw project te verwijzen met behulp van de knop met het beletselteken (rechts van het veld projectpad).
Notitie
Het dialoogvenster dat wordt weergegeven wanneer u naar de map van het Unity-project bladert, bevat '_' als de bestandsnaam. Er moet een waarde voor de bestandsnaam zijn om de map te kunnen selecteren.
Wanneer u de map van uw project hebt gevonden, klikt u op de knop Openen om terug te keren naar het Mixed Reality Functiehulpmiddel.
Belangrijk
De Mixed Reality Feature Tool voert validatie uit om ervoor te zorgen dat deze is omgeleid naar een Unity-projectmap. De map moet de mappen en Project SettingsPackages bevattenAssets.
Zodra het project is geselecteerd, kunt u
- Functies herstellen: download de pakketten die in het projectmanifest worden vermeld in het functiehulpprogramma naar Packages/MixedReality als ze daar nog niet aanwezig zijn. De functie is vergelijkbaar met in concept
nuget restore. Normaal gesproken hoeft u deze bewerking alleen uit te voeren als u een project (met functiehulpprogrammapakketten) hebt gekloond vanuit een opslagplaats die is geconfigureerd om tarball-bestanden te negeren. U kunt het functiehulpprogramma na het herstellen sluiten als u geen nieuwe pakketten nodig hebt.
Of
- Functies ontdekken: ga naar de volgende pagina om de pakketten te selecteren die u aan uw project wilt toevoegen.
3. Het detecteren en verkrijgen van functiepakketten
Functies zijn gegroepeerd op categorie om dingen gemakkelijker te vinden. De categorie Mixed Reality Toolkit heeft bijvoorbeeld verschillende functies waaruit u kunt kiezen:
Notitie
Als u de openbare preview-versie van MRTK3 in uw project gaat gebruiken, moet u inschakelen Show preview releases zoals hieronder wordt weergegeven in het rode vak.
Wanneer het hulpprogramma Mixed Reality functie eerder geïmporteerde functie(s) herkent, wordt een melding per onderdeel weergegeven.
Nadat u uw keuzes hebt gemaakt, selecteert u Functies ophalen om alle vereiste pakketten uit de catalogus te downloaden. Zie Functies detecteren en verkrijgen voor meer informatie.
4. Functiepakketten importeren
Na de overname wordt de volledige set pakketten weergegeven, samen met een lijst met vereiste afhankelijkheden. Als u functie- of pakketselecties wilt wijzigen, is dit het moment:
U wordt ten zeerste aangeraden de knop Valideren te gebruiken om ervoor te zorgen dat het Unity-project de geselecteerde functies kan importeren. Na de validatie ziet u een pop-updialoogvenster met een succesbericht of een lijst met geïdentificeerde problemen.
Selecteer Importeren om door te gaan.
Notitie
Nadat u op de knop Importeren hebt geklikt, wordt er een eenvoudig bericht weergegeven als er nog problemen zijn. U wordt aangeraden op Nee te klikken en de knop Valideren te gebruiken om de problemen weer te geven en op te lossen.
Zie Functies importeren voor meer informatie.
5. Projectwijzigingen beoordelen en goedkeuren
De laatste stap bestaat uit het beoordelen en goedkeuren van de voorgestelde wijzigingen in het manifest en de projectbestanden:
- De voorgestelde wijzigingen in het manifest worden aan de linkerkant weergegeven
- De bestanden die aan het project moeten worden toegevoegd, worden rechts weergegeven
- Met de knop Vergelijken kunt u het huidige manifest en de voorgestelde wijzigingen naast elkaar weergeven
Zie Projectwijzigingen controleren en goedkeuren voor meer informatie.
6. Project bijgewerkt
Wanneer de voorgestelde wijzigingen zijn goedgekeurd, wordt uw Unity-doelproject bijgewerkt om te verwijzen naar de geselecteerde Mixed Reality functies.
De map Packages van het Unity-project heeft nu een MixedReality-submap met de functiepakketbestanden en het manifest bevat de juiste verwijzing(en).
Ga terug naar Unity, wacht tot de nieuwe geselecteerde functies zijn geladen en begin met bouwen.