Sdílet prostřednictvím

Nastavení nového projektu OpenXR pomocí MRTK

  • Článek

Nejjednodušší způsob, jak nastavit projekt Unity pro hybridní realitu, je použít sadu nástrojů Mixed Reality Toolkit (MRTK). MRTK pro Unity je opensourcová vývojová sada pro různé platformy navržená tak, aby usnadnila vytváření úžasných aplikací hybridní reality.

Infografika znázorňující některé funkce sady Mixed Reality Toolkit

MRTK poskytuje vstupní systém pro různé platformy, základní komponenty a běžné stavební bloky pro prostorové interakce. Může vám pomoct urychlit vývoj aplikací pro Microsoft HoloLens, Windows Mixed Reality imerzivní náhlavní soupravy (VR) a řadu dalších zařízení pro virtuální realitu a rozšířenou realitu. Cílem projektu je snížit vstupní překážky a umožnit všem vytvářet aplikace pro hybridní realitu a přispívat zpět do komunity, jak všichni rosteme.

MRTK podporuje širokou škálu platforem, mezi které patří:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Náhlavní soupravy Windows Mixed Reality

  • Náhlavní soupravy OpenVR (HTC Vive / Oculus Rift)

  • Sledování rukou Ultraleap

  • Zařízení s Androidem a iOSem

Poznámka

Nedávno jsme představili MRTK3, třetí generaci sady Microsoft Mixed Reality Toolkit for Unity, která je postavená na systému pro správu XR od Unity a sadě nástrojů XR Interaction Toolkit, s lepší podporou pro řadu zařízení kompatibilních s OpenXR a novým návrhovým jazykem. Další informace najdete v dokumentaci k MRTK3.

Poznámka

Můžete také nastavit nový projekt OpenXR bez MRTK.

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.

    Snímek obrazovky Unity Hubu na kartě Projekty se zvýrazněným tlačítkem New Project (Nový projekt)

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

    Snímek obrazovky Unity Hubu se zobrazeným rozevíracím seznamem verze 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.

    Snímek obrazovky Unity Hubu se zvýrazněnou možností 3D, Název projektu, Umístění a Vytvořit

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

    Snímek obrazovky s projektem otevřeným 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:

    Snímek obrazovky s oknem Nastavení sestavení otevřeným v editoru unity se zvýrazněnou možností PC, Mac & Standalone platform

    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

    Snímek obrazovky s oknem Nastavení sestavení otevřeným v editoru unity se zvýrazněným Univerzální platforma Windows

  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.

    Snímek obrazovky s otevřením MixedRealityFeatureTool

Import balíčků Mixed Reality Toolkit a OpenXR

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

    Snímek obrazovky s úvodní obrazovkou nástroje funkce Mixed Reality

  2. Vyberte tlačítko Procházet (je to tlačítko se třemi tečky na obrázku níže), přejděte do projektu a otevřete ho.

    Otevření projektu

    Poznámka

    Pole Cesta k projektu v nástroji musí obsahovat 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.

    Snímek obrazovky s cestou projektu nástroje Mixed Reality funkce

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

    Hlavní skupiny balíčků v nástroji Mixed Reality Feature Tool

  5. Klikněte na tlačítko +nalevo od sady Mixed Reality Toolkit (0 z 10) a vyberte nejnovější verzi sady Mixed Reality Toolkit Foundation.

    Poznámka

    Balíček Mixed Reality Toolkit Foundation je jediný balíček, který je potřeba importovat a nakonfigurovat, aby bylo možné s projektem používat SADU MRTK. Tento balíček obsahuje základní komponenty potřebné k vytvoření aplikace s hybridní realitou.

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

    Snímek obrazovky s výběry balíčků v nástroji Mixed Reality Feature Tool

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

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

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

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

  11. Vyberte Schválit.

  12. 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 vaše balíčky importují.

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.

    Snímek obrazovky s možností restartování Unity

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, na řádku nabídek 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ě Univerzální platforma Windows.

    Snímek obrazovky s oknem Nastavení projektu, které se otevře 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 pak v části Poskytovatelé modulů plug-in klikněte na OpenXR.

    Snímek obrazovky s oknem Nastavení projektu uvnitř Univerzální platforma Windows s vybranou možností Inicializovat XR při spuštění a zvýrazněným modulem plug-in OpenXR

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

    Snímek obrazovky s oknem Nastavení projektu se zvýrazněným modulem plug-in OpenXR a skupinou funkcí Microsoft HoloLens

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 věnovanou 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 kliknutím na Mixed Reality > Nastavení > ověření projektu Win32 Aplikace (samostatně) 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ůž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.

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 .

    Snímek obrazovky s oknem Nastavení projektu otevřeným 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 pak v části Poskytovatelé modulů plug-in klikněte na OpenXR.

    Snímek obrazovky s oknem Nastavení projektu na kartě PC, Mac & Linux Standalone s vybranou možností Inicializovat XR při spuštění a zvýrazněným modulem plug-in OpenXR

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

    Snímek obrazovky s oknem Nastavení projektu se zvýrazněnou skupinou funkcí OpenXR a Windows Mixed Reality

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 to 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 pro kartu Desktop VR jsou ale stejné, s výjimkou případu, kdy je uvedeno.

  1. Najeďte kurzorem na žlutý trojúhelník upozornění vedle OpenXR, přečtěte si zprávu v automaticky otevírané nabídce a vyberte trojúhelník.

    Snímek obrazovky s upozorněním na nekompatibilní nastavení

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

    Snímek obrazovky s tlačítkem Opravit vše v okně Ověření projektu OpenXR

  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 k nastavení modulu plug-in OpenXR v okně Nastavení projektu .

    Snímek obrazovky okna Nastavení projektu se zobrazeným nastavením OpenXR

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

    Snímek obrazovky s tlačítkem Přidat profil interakce

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

    Profil interakce očního pohledu

    Microsoft Hand Interaction Profile

    Microsoft Motion Controller Profile

    Snímek obrazovky s profily interakce, které by se měly přidat

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

    Snímek obrazovky s tlačítkem Opravit pro profil interakce Eye Gaze

  6. V okně Project Settings (Nastavení projektu ) v části OpenXR Feature Groups (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

    Snímek obrazovky se skupinami funkcí OpenXR pro kartu Desktop VR

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

    Microsoft HoloLens

    Sledování rukou

    Model ovladače pohybu

    Snímek obrazovky s vybranými funkcemi pro OpenXR

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

    Snímek obrazovky s 16bitovou hloubkou vybranou pro režim odeslání hloubky

    Tip

    Zmenšení formátu hloubky na 16bitovou verzi je volitelné, ale může to zlepšit grafický výkon v 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 odeslání hloubky, 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ší způsob vykreslování v Unity, abyste ušetřili čas procesoru i GPU. Vykreslování instance s jedním průchodem je v tomto případě nejlepší volbou – doporučujeme ho ve výchozím nastavení povolit pro každý projekt. Další informace najdete v dokumentaci k Unity.

Konfigurace nastavení přehrávače

  1. Ve sloupci na levé straně 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.

    Snímek obrazovky s nastavením publikování Unity a vyplněným polem Název projektu

    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.

    Snímek obrazovky s nastavením publikování Unity s vyplněným polem s názvem balíčku

    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é