Nastavení nového projektu OpenXR bez MRTK

I když Microsoft a komunita vytvořily open source nástroje, jako je Mixed Reality Toolkit (MRTK), které automaticky nastaví prostředí pro hybridní realitu, někteří vývojáři můžou chtít vytvářet své prostředí od základů.

Další možnosti konfigurace mimo OpenXR, které je potřeba zvážit

Windows XR: Microsoft nedoporučuje používat modul plug-in Windows XR pro žádné nové projekty v Unity 2020. Místo toho byste měli použít Mixed Reality modul plug-in OpenXR. Pokud ale používáte Unity 2019 a potřebujete AR Foundation 2.0 kvůli kompatibilitě se zařízeními ARCore/ARKit, tento modul plug-in tuto podporu povolí.

Důležité

Použití tohoto modulu plug-in v Unity 2019 není kompatibilní s Azure Spatial Anchors.

Starší verze XR:

Pokud stále používáte Unity 2019 nebo starší verzi, Microsoft doporučuje používat starší integrovanou podporu XR. Modul plug-in Windows XR je sice v Unity 2019 funkční, ale nedoporučujeme ho, protože není kompatibilní s Azure Spatial Anchors v Unity 2019.

Pokud začínáte nový projekt, doporučujeme místo toho nainstalovat Unity 2020 a použít Mixed Reality modul plug-in OpenXR.

Začínáme s OpenXR: Vytvoření nového projektu Unity

1. Spusťte Unity Hub.

2. Na kartě Projekty klikněte na Nový projekt.

   

3. Klikněte na rozevírací seznam pod položkou Nový projekt a vyberte požadovanou verzi editoru.

   

4. Ujistěte se, že vybraná šablona je 3D Core.

5. Do pole Název projektu zadejte název projektu, například Kurz MRTK.

6. V poli Umístění klikněte na ikonu složky a přejděte do složky, do které chcete projekt uložit, a vyberte ji. Můžete také vytvořit novou složku.

   

7. Klikněte na Create Project (Vytvořit projekt). Tím se projekt otevře v Unity.

   

Upozornění

Pokud pracujete ve Windows, limit pro cestu je 255 znaků. Tyto limity se v Unity projeví – cesta k souboru delší než 255 znaků by mohla způsobit selhání kompilace. Proto doporučujeme, abyste projekt Unity uložili co nejblíže kořenovému adresáři jednotky.

Nastavení cíle sestavení

1. V řádku nabídek vyberteNastavení sestavenísouboru>....

   Pokud chcete vytvořit aplikaci pro Windows Mixed Reality, musíte zvolit cíl sestavení. Nastavení sestavení pro Univerzální platforma Windows (UPW) cílí na všechna zařízení, včetně imerzivních náhlavních souprav, jako je HP Reverb G2. To je nejlepší volba, pokud vytváříte pro HoloLens 2. Pokud ale cílíte na desktopovou virtuální realitu, doporučujeme používat PC, Mac & Linux Standalone platformu.

2. Proveďte některou z následujících akcí:

   Pokud cílíte na Desktop VR:

   • Ponechte počítač PC, Mac & samostatnou platformu Linux, která je ve výchozím nastavení vybraná pro nový projekt Unity:

   

   Pokud cílíte na HoloLens 2:

   • V části Platforma vyberte Univerzální platforma Windows. Ujistěte se, že jsou aktivní následující nastavení:

   Typ sestavení: Projekt D3D

   Cílová verze sady SDK: Nejnovější nainstalovaná verze

   Minimální verze platformy: 10.0.10240.0

   Verze sady Visual Studio: Nejnovější nainstalovaná verze

   

3. Klikněte na tlačítko Přepnout platformu . Unity při přepínání platforem zobrazuje indikátor průběhu.

4. Po dokončení procesu přepnutí platformy zavřete okno Nastavení sestavení .

Stažení a instalace nástroje Mixed Reality Feature Tool

Modul plug-in Mixed Reality OpenXR se dodává ve formě balíčku pro Unity. Nejlepší způsob, jak zjistit, aktualizovat a importovat balíčky funkcí, je použít nástroj Mixed Reality Feature Tool. Před importem můžete balíčky prohledávat podle názvu nebo kategorie, zobrazit jejich závislosti a zobrazit navrhované změny v souboru manifestu projektu.

1. Stáhněte si nejnovější verzi nástroje Mixed Reality Feature Tool z webu Microsoft Download Center.

2. Po dokončení stahování přejděte na spustitelný soubor MixedRealityFeatureTool.exe a pak ho použijte ke spuštění nástroje Mixed Reality Feature Tool.

   

Import Mixed Reality modulu plug-in OpenXR

1. V nástroji Mixed Reality funkce vyberte Start.

   

2. Vyberte tlačítko Procházet (je to tlačítko se třemi tečky na obrázku níže), pak přejděte do složky obsahující váš projekt Unity a otevřete ho.

   

   Poznámka

   Pole Cesta k projektu v nástroji musí obsahovat určitou hodnotu, takže ve výchozím nastavení vloží zpětné lomítko ("_").

   Po výběru složky nástroj zkontroluje, jestli se jedná o platnou složku projektu Unity.

   

3. Vyberte Zjistit funkce.

   Poznámka: Možná budete muset několik sekund počkat, než nástroj aktualizuje balíčky z informačních kanálů.

4. Na stránce Discover Features (Zjistit funkce ) je seznam šesti skupin balíčků.

   

5. Klikněte na tlačítko + nalevo od podpory platformy (0 z 5) a pak vyberte nejnovější verzi modulu plug-in Mixed Reality OpenXR.

   

6. Po výběru klikněte na Získat funkce.

7. Výběrem možnosti Ověřit ověřte vybrané balíčky. Mělo by se zobrazit dialogové okno s informací , že nebyly zjištěny žádné problémy s ověřením. Až to uděláte, klikněte na OK.

8. Na stránce Importovat funkce se v levém sloupci Funkce zobrazují balíčky, které jste právě vybrali. V pravém sloupci Povinné závislosti se zobrazí všechny závislosti. Další informace o těchto položkách získáte kliknutím na odkaz Podrobnosti .

9. Až budete připraveni pokračovat, vyberte Importovat. Na stránce Zkontrolovat a schválit můžete zkontrolovat informace o balíčcích.

10. Vyberte Schválit.

11. Vraťte se do Unity Editoru a klikněte do prázdné oblasti v uživatelském rozhraní. Zobrazí se indikátor průběhu, který ukazuje, že se balíček importuje.

Konfigurace nastavení vstupního back-endu

1. Jakmile Unity naimportuje balíček, zobrazí se upozornění s dotazem, jestli chcete povolit back-endy restartováním editoru. Vyberte Ano.

   

Konfigurace projektu pro HoloLens 2 prostřednictvím ověření projektu (MR OpenXR 1.6+)

Pokud vyvíjíte pro desktopovou virtuální realitu, přeskočte tuto část a přejděte do části Konfigurace projektu pro desktopovou virtuální realitu.

1. Na řádku nabídek kliknutím na Mixed Reality > Nastavení > ověření projektu HoloLens 2 aplikace (UPW) povolte ověřovací pravidla pro HoloLens 2. V případě modulů plug-in MR OpenXR před verzí 1.9 je dostupná položka nabídky Mixed Reality > Projekt > Použít doporučená nastavení projektu pro HoloLens 2.
2. V okně ověření projektu, které se zobrazí, se ujistěte, že jste na kartě platforma UPW (označená logem Windows), a kliknutím na Opravit vše vyřešte problémy s ověřováním. Všimněte si, že po kliknutí na Opravit vše můžou zůstat problémy. V takovém případě zkuste znovu kliknout na Opravit , ignorovat všechny problémy, které jsou označené jako specifické pro scénu (pokud existují), a projděte si zbývající problémy (pokud existují) a podívejte se, jestli chcete provést nějaké navrhované změny.
3. Projekt je v tuto chvíli téměř připravený k HoloLens 2 nasazení. V dalším kroku přejděte ke konfiguraci nastavení přehrávače .

Ruční konfigurace projektu pro HoloLens 2

Pokud vyvíjíte pro desktopovou virtuální realitu, přeskočte tuto část a přejděte do části Konfigurace projektu pro desktopovou virtuální realitu.

1. Ujistěte se, že je otevřené okno Nastavení projektu . Pokud ne, vyberte na řádku nabídek Upravit>nastavení projektu.

2. V okně Nastavení projektu se ujistěte, že jste na stránce Správa modulů plug-in XR a na kartě Univerzální platforma Windows.

   

3. Ujistěte se, že je vybraná možnost Inicializovat XR při spuštění a potom v části Poskytovatelé modulů plug-in klikněte na OpenXR.

   

4. Modul plug-in OpenXR se načte a pod OpenXR se zobrazí několik položek. Vyberte Microsoft HoloLens skupinu funkcí.

   

Všimněte si, že vedle OpenXR je žlutý trojúhelník s upozorněním. To znamená, že máte nekompatibilní nastavení, která je potřeba vyřešit. Pokud chcete zjistit, jak tento problém vyřešit, přeskočte další část o konfiguraci virtuální reality a pokračujte v následující části Řešení nekompatibilních nastavení.

Konfigurace projektu pro desktopovou virtuální realitu prostřednictvím ověření projektu (MR OpenXR 1.9+)

1. Na řádku nabídek klikněte na Mixed Reality > Nastavení > ověření projektu Win32 Aplikace (samostatná) a povolte ověřovací pravidla pro desktopovou aplikaci XR.
2. V okně ověření projektu, které se zobrazí, se ujistěte, že jste na kartě Samostatná platforma, a kliknutím na Opravit vše vyřešte problémy s ověřováním. Všimněte si, že po kliknutí na Opravit vše může docházet k problémům. V takovém případě zkuste znovu kliknout na Opravit , ignorovat všechny problémy, které jsou označené jako "specifické pro scénu" (pokud existují) a projděte si zbývající problémy (pokud nějaké existují), abyste zjistili, jestli chcete provést nějaké navrhované změny.

Ruční konfigurace projektu pro desktopovou virtuální realitu

1. Ujistěte se, že je otevřené okno Nastavení projektu . Pokud ne, přejděte na řádek nabídek a vyberte Upravit>nastavení projektu.

2. V okně Nastavení projektu se ujistěte, že jste na stránce Správa modulů plug-in XR a na kartě Pc, Mac & Linux Standalone .

   

3. Ujistěte se, že je vybraná možnost Inicializovat XR při spuštění a potom v části Poskytovatelé modulů plug-in klikněte na OpenXR.

   

4. Modul plug-in OpenXR se načte a pod OpenXR se zobrazí dvě položky. Vyberte první Windows Mixed Reality skupinu funkcí.

   

Všimněte si, že vedle OpenXR je teď žlutý trojúhelník s upozorněním. To znamená, že máte nekompatibilní nastavení, která je potřeba vyřešit. Pokud chcete zjistit, jak tento postup vyřešit, pokračujte k další části Řešení nekompatibilních nastavení.

Řešení nekompatibilních nastavení

Důležité

Obrázky v této části zobrazují možnosti na kartě Univerzální platforma Windows. Pokyny jsou ale pro kartu Desktop VR stejné, s výjimkou případu, kdy je uvedeno.

1. Najeďte myší na žlutý trojúhelník s upozorněním vedle OpenXR, přečtěte si zprávu v místní nabídce a vyberte trojúhelník.

   

2. V okně OpenXR Project Validation (Ověření projektu OpenXR ) je uvedeno několik problémů. Vyberte tlačítko Opravit vše . POZNÁMKA: Tento seznam může vypadat jinak v závislosti na tom, na které kartě se právě nacházíte.

   

3. Jeden problém přetrvává a říká vám, že musíte přidat aspoň jeden profil interakce. Uděláte to tak, že kliknete na Upravit. Tím přejdete na nastavení modulu plug-in OpenXR v okně Nastavení projektu .

   

4. Pod profily interakce si všimněte tlačítka znaménko plus (+).

   

5. Klikněte na tlačítko třikrát, pokaždé zvolte jiný profil:

   Profil interakce očního pohledu

   Microsoft Hand Interaction Profile

   Microsoft Motion Controller Profile

   

   Pokud se zobrazí profil interakce očního pohledu nebo jakýkoli jiný profil se žlutým trojúhelníkem vedle něj, vyberte trojúhelník a potom v okně OpenXR Project Validation klikněte na tlačítko Opravit . Až budete hotovi, zavřete okno Ověření projektu OpenXR .

   

6. V okně Nastavení projektu v části Skupiny funkcí OpenXR se ujistěte, že jsou vybrané následující možnosti:

   Pokud jste na kartě Desktop VR:

   Windows Mixed Reality

   Sledování rukou

   Model ovladače pohybu

   

   Pokud jste na kartě Univerzální platforma Windows:

   Microsoft HoloLens

   Sledování rukou

   Model ovladače pohybu

   

7. Klikněte na rozevírací seznam Režim odeslání hloubky a pak vyberte Hloubka 16 bitů.

   

   Tip

   Zmenšení formátu hloubky na 16bitovou verzi je volitelné, ale může to zlepšit grafický výkon ve vašem projektu. Další informace najdete v tématu Sdílení hloubkové vyrovnávací paměti (HoloLens).

   Poznámka

   Nastavení Režim vykreslování , které se nachází těsně nad režimem hloubkového odeslání, je ve výchozím nastavení nastaveno na Instanced s jedním průchodem. V aplikacích hybridní reality se scéna vykresluje dvakrát: jednou pro každé oko. Výsledkem je "stereoskopické vidění". Tím se zdvojnásobí množství potřebných výpočetních prostředků, takže je důležité vybrat nejúčinnější cestu vykreslování v Unity, abyste ušetřili čas procesoru i GPU. Vykreslování instance s jedním průchodem je zde nejlepší volbou – doporučujeme ho povolit ve výchozím nastavení pro každý projekt. Další informace najdete v dokumentaci k Unity.

Konfigurace nastavení přehrávače

1. V levém sloupci okna Nastavení projektu vyberte Přehrávač.

2. Všimněte si, že v okně Player (Přehrávač ) je pole Product Name (Název produktu ) už vyplněné. Toto je převzato z názvu projektu a bude to název zobrazený v nabídce HoloLens Start.

   

   Tip

   Pokud chcete aplikaci snadněji najít během vývoje, přidejte před název podtržítko, které ji seřadí na začátek libovolného seznamu.

3. Klikněte na rozevírací seznam Nastavení publikování a do pole Název balíčku zadejte vhodný název.

   

   Poznámka

   Název balíčku je jedinečný identifikátor aplikace. Pokud se chcete vyhnout přepsání dříve nainstalovaných verzí aplikace se stejným názvem, měli byste tento identifikátor před nasazením aplikace změnit.

4. Zavřete okno Nastavení projektu .

Teď jste připraveni začít vyvíjet s OpenXR v Unity!

Ukázkové projekty Unity

Podívejte se na úložiště ukázek OpenXR Mixed Reality pro ukázkové projekty Unity, které ukazují, jak vytvářet aplikace Unity pro HoloLens 2 nebo Mixed Reality náhlavní soupravy pomocí modulu plug-in Mixed Reality OpenXR.

Viz také

• Nastavení nového projektu OpenXR pomocí MRTK
• Přidání modulu plug-in Mixed Reality OpenXR do existujícího projektu Unity