Začínáme s OpenXR

Můžete vyvíjet pomocí OpenXR na počítači HoloLens 2 nebo Windows Mixed Reality imerzivní náhlavní soupravou na ploše. Pokud nemáte přístup k náhlavní soupravě, můžete místo toho použít HoloLens 2 Emulator nebo Windows Mixed Reality zařízení.

Začínáme s OpenXR pro HoloLens 2

Zahájení vývoje aplikací OpenXR pro HoloLens 2:

  1. Nastavte HoloLens 2 nebo postupujte podle pokynů k instalaci nejnovější verze emulátoru HoloLens 2. Pokud používáte nedávnou image emulátoru nebo pokud zařízení aktualizovalo operační systém, měli byste už mít OpenXR 1.0 připravený k použití.
  2. Spuštěním aplikace Store ze zařízení nebo emulátoru se ujistěte, že máte nejnovější modul runtime OpenXR se všemi rozšířeními.
    • Otevřete nabídku v pravém horním rohu, vyberte Stažené souborya aktualizace a zvolte Získat aktualizace.

Poznámka

Pokud používáte emulátor, image emulátoru se při každém spuštění resetuje, takže je nejlepší se ujistit, že máte nejnovější verzi image emulátoru HoloLens 2.

Začínáme s OpenXR pro Windows Mixed Reality náhlavní soupravy

Zahájení vývoje aplikací OpenXR pro imerzivní Windows Mixed Reality náhlavní soupravy:

  1. Ujistěte se, že používáte minimálně Aktualizace Windows 10 z května 2019 (1903), což je minimální požadavek, aby koncoví Windows Mixed Reality spouštěi aplikace OpenXR. Pokud používáte starší verzi nástroje Windows 10, můžete upgradovat pomocí nástroje Windows 10 Update Assistant.
  2. Nastavte náhlavní Windows Mixed Reality nebo podle pokynů povolte simulátor Windows Mixed Reality zařízení.

A to je vše! Modul Windows Mixed Reality OpenXR je nainstalován a automaticky aktivní pro všechny Windows Mixed Reality uživatele. Aplikace Microsoft Store pak udržuje modul runtime aktuální.

Pokud chcete Windows Mixed Reality openxr runtime, spusťte Portál hybridní reality z nabídka Start a v horní části okna vyberte Opravit. Pokud toto tlačítko chybí, modul runtime OpenXR je už aktivní.

Získání Vývojářské nástroje OpenXR Windows Mixed Reality

Pokud si chcete Windows Mixed Reality OpenXR Runtime, můžete si nainstalovat openxr Vývojářské nástroje pro Windows Mixed Reality aplikaci. Tato aplikace poskytuje ukázku různých funkcí OpenXR spolu se stránkou Stav systému s klíčovými informacemi o aktivním modulu runtime a aktuální náhlavní soupravě.

Při použití emulátoru HoloLens 2 je nejjednodušší způsob instalace openxr Vývojářské nástroje pro Windows Mixed Reality prostřednictvím Windows Portál zařízení . Přechod na stránku OpenXR a kliknutí na tlačítko Nainstalovat v části Vývojářské funkce funguje také na fyzických HoloLens 2 zařízeních.

OpenXR Vývojářské nástroje pro Windows Mixed Reality aplikaci

Seznámení s rozhraním API OpenXR a ukázkovou aplikací

Pokud jste to ještě neudělali, nainstalujte si nástroje, které budete potřebovat pro vývoj v OpenXR.

Projekt BasicXrApp zobrazuje jednoduchou ukázku OpenXR se soubory projektu Win32 a UPW HoloLens 2 v Visual Studio. Vzhledem k tomu, že řešení obsahuje projekt HoloLens UPW, budete k jeho úplnému otevření potřebovat nainstalovanou úlohu vývoje pro Univerzální Windows Platformu Visual Studio platformě.

I když jsou soubory projektu Win32 a UPW oddělené kvůli rozdílům v balení a nasazování, kód aplikace uvnitř každého projektu je téměř úplně stejný!

Spuštění aplikace OpenXR

Po vytvoření desktopové .EXE OpenXR Win32 ji můžete použít s náhlavní soupravou VR na libovolné desktopové platformě VR, která podporuje OpenXR bez ohledu na typ náhlavní soupravy.

Po vytvoření balíčku aplikace Pro UPW OpenXR můžete tento balíček nasadit do zařízení HoloLens 2 nebo do HoloLens 2 Emulator.

Učení rozhraní API OpenXR

Pokud si chcete prohlédněte rozhraní API OpenXR, podívejte se na toto 60minutové video ukázky BasicXrApp v Visual Studio. Video ukazuje, jak můžete jednotlivé hlavní komponenty rozhraní OpenXR API použít ve vlastním modulu, a také ukazuje některé z aplikací postavených na OpenXR dnes:

Použití OpenXR v existujícím projektu

Pokud chcete začít používat OpenXR v existujícím projektu, zavaděč OpenXR. Zavaděč zjistí na zařízení aktivní modul runtime OpenXR a poskytne přístup k základním funkcím a funkcím rozšíření, které implementuje.

Můžete odkazovat na oficiální NuGet OpenXR z projektu Visual Studio nebo zahrnout oficiální zdroj zavaděče OpenXR z GitHub Khronos. Který z těchto přístupů vám poskytne přístup k základním funkcím OpenXR 1.0 a publikovaných KHR rozšíření EXT a MSFT .

Pokud chcete také experimentovat s rozšířeními, můžete zkopírovat hlavičky MSFT_previewMSFT_preview ve verzi Preview z Mixed Reality GitHub dat.

Referenční oficiální NuGet OpenXR

Balíček NuGet OpenXR.Loader představuje nejjednodušší způsob, jak odkazovat na předem připravený zavaděč OpenXR .DLL ve vašem Visual Studio C++. To vám poskytne přístup k základním funkcím OpenXR 1.0 a publikovaných KHR rozšíření EXT a MSFT .

Přidání odkazu balíčku OpenXR.Loader NuGet balíčku do vašeho Visual Studio C++:

  1. V Průzkumník řešení klikněte pravým tlačítkem na projekt, který bude používat OpenXR, avyberte Spravovat NuGet balíčky....
  2. Přepněte na kartu Procházet a vyhledejte OpenXR.Loader.
  3. Vyberte balíček OpenXR.Loader a vpravo v podokně podrobností vyberte Nainstalovat.
  4. Vyberte OK a přijměte změny projektu.
  5. Přidejte #include <openxr/openxr.h> do zdrojového souboru, abyste začali používat rozhraní API OpenXR.

Pokud se chcete podívat na příklad rozhraní API OpenXR v akci, podívejte se na ukázkovou aplikaci BasicXrApp.

Zahrnutí oficiálního zdroje zavaděče OpenXR

Pokud chcete zavaděč sestavit sami, například abyste se vyhnuli dodatečnému zavaděči .DLL, můžete do svého projektu stáhnout oficiální zdroje zavaděče Khronos OpenXR. To vám poskytne přístup k základním funkcím OpenXR 1.0 a publikovaných KHR rozšíření EXT a MSFT .

Pokud chcete začít tady, postupujte podle pokynů v repo Khronos OpenXR-SDK na GitHub. Projekt je nastavený tak, aby se sestavil pomocí CMake – pokud používáte MSBuild, budete muset zkopírovat kód do vlastního projektu.

Použití rozšíření ve verzi Preview

Rozšíření uvedená v plánu rozšíření jsou experimentální rozšíření dodavatelů ve verzi Preview, která shromažďují MSFT_preview zpětnou vazbu. MSFT_preview Tato rozšíření jsou jenom pro vývojářská zařízení a při skutečném dodávání rozšíření se odstraní.

Pokud si chcete vyzkoušet dostupná rozšíření, postupujte podle MSFT_preview následujících kroků a aktualizujte projekt:

  1. Pokud chcete do svého projektu integrovat zavaděč OpenXR, postupujte podle jednoho z výše uvedených přístupů.
  2. Nahraďte standardní hlavičky OpenXR ve vašem projektu hlavičkami náhledu z Mixed Reality OpenXR na GitHub.

Pokud pak chcete aktivovat podporu rozšíření ve verzi Preview na cílovém počítači HoloLens 2 nebo stolním počítači:

  1. Pokud se chcete ujistit, že máte nejnovější modul runtime OpenXR se všemi přítomných rozšířeními, spusťte aplikaci Pro Store z cílového zařízení nebo emulátoru, otevřete nabídku v pravém horním rohu, vyberte Stažené soubory a aktualizace a zvolte Získat aktualizace.
  2. Nainstalujte soubor OpenXR Vývojářské nástroje pro Windows Mixed Reality z Microsoft Store do cílového zařízení a spusťte ho.
  3. Přejděte na kartu Vývojářský Nastavení a povolte možnost Použít nejnovější verzi Preview modulu runtime OpenXR. Tím se na vašem zařízení povolí modul runtime ve verzi Preview, který má aktivovaná rozšíření preview. OpenXR Vývojářské nástroje pro Windows Mixed Reality vývojářské aplikace Nastavení
  4. Ověřte, že verze modulu runtime zobrazená na kartě Stav systému openXR Vývojářské nástroje pro Windows Mixed Reality odpovídá požadované verzi rozšíření ve verzi Preview, která chcete vyzkoušet. Pokud ano, měli byste rozšíření vidět v seznamu Rozšíření. Jakmile je k dispozici stabilní rozšíření, jeho rozšíření ve verzi Preview se odebere.
    OpenXR Vývojářské nástroje pro Windows Mixed Reality stav systému aplikace

Dokumentaci k těmto Mixed Reality Preview a ukázky jejich použití najdete v článku o Mixed Reality OpenXR.

Řešení potíží

Pokud máte potíže s vývojem OpenXR a s jeho spuštěním, podívejte se na naše tipy pro řešení potíží.