Zahájení od nového projektu

Vzhledem k tomu, že MRTK3 je kolekce volně propojených balíčků, použití MRTK3 se provádí jinak než ve způsobu, jakým používáte MRTK 2.x. Sadu MRTK nedoručujeme jako projekt Unity, takže abyste mohli balíčky MRTK3 používat, musíte je do projektu přidat ručně.

Neočekává se, že budete využívat každý balíček MRTK. Podívejte se, které funkce jsou pro vás užitečné , a přidejte jenom závislosti, na kterých záleží.

Nastavení nového projektu Unity pomocí MRTK3

1. Vytvoření nového projektu Unity

Vytvořte nový projekt Unity s Unity 2021.3.21f1 nebo novějším. Než budete pokračovat k dalšímu kroku, zavřete projekt Unity.

2. Import požadovaných závislostí a balíčků MRTK3 pomocí nástroje Mixed Reality Feature Tool

MrTK3 používá několik balíčků, které nejsou součástí této sady nástrojů. Pokud chcete získat tyto balíčky, použijte Mixed Reality Feature Tool a vyberte nejnovější verzi následujícího postupu v kroku Zjistit funkce .

• Podpora platformy → Mixed Reality modul plug-in OpenXR
• Spatial Audio → Microsoft Spatializer (volitelné)

Pro balíčky MRTK3 důrazně doporučujeme následující dva balíčky, které vám pomůžou rychle začít:

• MRTK3 → vstup MRTK (vyžaduje se pro toto nastavení)
• MRTK3 → komponenty UX MRTK

Tyto dva balíčky spolu s jejich závislostmi (automaticky přidané nástrojem Feature Tool) vám umožní prozkoumat většinu našich nabídek uživatelského prostředí a vytvářet projekty připravené k nasazení na různá zařízení XR. K nástroji funkcí se můžete kdykoli vrátit a později do projektu přidat další balíčky.

Nezapomeňte vybrat org.mixedrealitytoolkit.* balíčky, a ne zastaralé balíčky. Balíčky com.microsoft.mrtk.* jsou zastaralé a už se nepodporují.

Poznámka

Další informace o balíčcích MRTK3 najdete na stránce s přehledem balíčků.

Po výběru balíčků klikněte na Získat funkce a pak podle pokynů v nástroji Mixed Reality Funkce naimportujte vybrané balíčky do projektu Unity.

3. Otevřete projekt Unity.

Otevřete projekt Unity a počkejte, až Unity dokončí import nově přidaných balíčků. V tomto procesu můžou být dvě automaticky otevírané zprávy:

1. První zpráva se zeptá, jestli chcete povolit nový vstupní back-end. Vyberte Ano.
2. Druhá zpráva se ptá, jestli chcete aktualizovat XR InteractionLayerMask. Vyberte No Thanks (Ne, děkuji).

Unity se může během tohoto procesu několikrát restartovat – počkejte na jeho dokončení, než budete pokračovat.

4. Konfigurace profilu MRTK po importu

Po importu MRTK3 vyžaduje nastavení profilu pro samostatnou cílovou platformu a každou další cílovou platformu.

1. Přejděte na Upravit > nastavení projektu.

2. V části Nastavení projektu přejděte na MRTK3 a pak přepněte na samostatnou kartu. Všimněte si, že profil není na začátku zadaný.

3. Vyplňte pole výchozím profilem MRTK, který se dodává se základním balíčkem. Můžete zadat klíčové slovo "MRTKprofile" na panelu hledání okna projektu; zkontrolujte, že hledáte v All. Případně můžete profil najít v části Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset.

   Poznámka

   Na následujícím snímku obrazovky se nezobrazují všechny subsystémy MRTK. Zobrazené subsystémy MRTK se můžou lišit v závislosti na balíčcích MRTK3, které jste přidali do projektu.

   

4. Přepněte na karty dalších cílů sestavení, které chcete použít (například UPW nebo Android), a zkontrolujte, jestli je profil přiřazený. Pokud ne, opakujte předchozí krok na aktuální kartě.

5. Konfigurace nastavení souvisejících s OpenXR

Pokud cílíte na zařízení XR, jako je například HoloLens 2 nebo Quest, po importu MRTK3 vyžaduje určitou konfiguraci v OpenXR.

Poznámka

Následující pokyny platí pro náhlavní soupravy HoloLens 2 nebo WMR. Pokud cílíte na úkol, postupujte podle pokynů na stránce nasazení úkolu.

1. Přejděte na Upravit > nastavení projektu.

2. V části Nastavení projektu přejděte na Správa modulů plug-in XR a na kartách Standalone i UPW povolte OpenXR . Na každé kartě se ujistěte, že je vybraná možnost Initialize XR on Startup (Inicializovat XR při spuštění) a že jsou povoleny Windows Mixed Reality skupiny funkcí v části Standalone (Samostatně) a Microsoft HoloLens skupina funkcí v části UPW.

   Poznámka

   Po zaškrtnutí možnosti OpenXR se může zobrazit žlutá ikona upozornění. Kliknutím na ikonu otevřete nástroj OpenXR Project Validation . Klikněte na Opravit vše a ignorujte problém s profilem interakce, který nejde opravit automaticky. Profily se přidají v následujícím kroku.

   Pro samostatnou službu:

   

   Pro UPW:

   

3. V části Project Settings (Nastavení projektu) přejděte na XR Plug-in Management > OpenXR Interaction Profiles (Profily interakce OpenXR>) a přidejte následující tři profily pro UPW a Standalone (Samostatně):

   • Profil interakce očního pohledu
   • Microsoft Hand Interaction Profile
   • Microsoft Motion Controller Profile

   Poznámka

   K odstranění žlutého trojúhelníku možná budete muset použít nástroj OpenXR Project Validation Tool. Některá upozornění se můžou vyřešit ručně:
   1. V části Nastavení projektu přejděte na Rozlišení přehrávače > a prezentace. Ujistěte se, že není zaškrtnuté políčko Spustit na pozadí .
   2. V případě UPW se v části Možnosti nastavení > publikování přehrávače >ujistěte, že je zaškrtnuté políčko WebCam, Microphone, SpatialPerception a GazeInput, pokud aplikace tyto funkce potřebuje. Další informace o možnostech aplikace Window najdete v tématu Deklarace schopností aplikace.

   Pro samostatnou službu:

   

   Pro UPW:

   

4. V případě HoloLens 2 doporučujeme v nastaveních výše nastavit režim odesílání hloubky na 16bitový.

5. Pro imerzivní náhlavní soupravy můžete použít 24bitové hloubkové odesílání. Další informace najdete v dokumentaci microsoftu k vývoji pro Unity .

6. Blahopřejeme, nastavení projektu je nyní dokončeno

Pokračujte vytvořením nové scény MRTK3.

Další kroky

Jakmile dokončíte nastavení projektu Unity, naučte se používat aplikaci na zařízení.