Az OpenXR első lépések

Az OpenXR használatával fejleszthet egy HoloLens 2 vagy Windows Mixed Reality modern headseten az asztalon. Ha nem rendelkezik hozzáféréssel egy headsethez, használhatja a HoloLens 2 Emulator vagy a Windows Mixed Reality Simulatort.

Az OpenXR for HoloLens 2 első lépések

OpenXR-alkalmazások fejlesztése a 2. HoloLens:

  1. Állítson be egy HoloLens 2-es verziót, vagy kövesse az utasításokat a HoloLens 2 emulátor legújabb verziójának telepítéséhez. Az OpenXR 1.0-nak már készen kell állnia, ha egy közelmúltbeli emulátorrendszerképet használ, vagy ha az eszköz frissítette az operációs rendszert.
  2. Az Áruház alkalmazás eszközről vagy emulátorról való elindításával győződjön meg arról, hogy a legújabb OpenXR-futásidőt és az összes bővítményt rendelkezésre bocsátja.
    • Nyissa meg a jobb felső menüt, válassza a Letöltések ésfrissítések lehetőséget, majd válassza a Frissítések betöltése lehetőséget.

Megjegyzés

Ha az emulátort használja, az emulátor rendszerképe minden indításkor alaphelyzetbe áll, így a legjobb megoldás, ha az HoloLens 2 emulátorrendszerképének legújabb verzióját használja.

Ismerkedés az OpenXR-sel Windows Mixed Reality headsetekkel

OpenXR-alkalmazások fejlesztése modern Windows Mixed Reality headsetek számára:

  1. Győződjön meg arról, hogy legalább a Windows 10 2019. májusi frissítése (1903) alkalmazást futtatja, ami minimális követelmény ahhoz, hogy Windows Mixed Reality végfelhasználók OpenXR-alkalmazásokat futtassanak. Ha az alkalmazás korábbi verzióját használja, Windows 10 frissítési segéd használatával Windows 10 frissíteni.
  2. Állítson be egy Windows Mixed Reality headsetet, vagy kövesse az utasításokat a Windows Mixed Reality engedélyezéséhez.

Ennyi az egész! Az Windows Mixed Reality OpenXR-futtatás telepítése és automatikus aktívvá Windows Mixed Reality felhasználók számára. A Microsoft Store tartja naprakészen a futásidőt.

A Windows Mixed Reality OpenXR Runtime aktiválásához indítsa el a Vegyes valóság portál-t a Start menü- és válassza a "Javítás" lehetőséget az ablak tetején. Ha ez a gomb hiányzik, az OpenXR-futtatás már aktív.

Az OpenXR-Fejlesztői eszközök lekért Windows Mixed Reality

Az OpenXR Runtime Windows Mixed Reality az OpenXR-Fejlesztői eszközökaz Windows Mixed Reality alkalmazáshoz. Ez az alkalmazás az OpenXR különböző funkcióinak bemutatóját, valamint egy Rendszerállapot oldalt biztosít, amely az aktív futásidővel és az aktuális headsettel kapcsolatos fontos információkat tartalmaz.

Az HoloLens 2 emulátor használata esetén az OpenXR Fejlesztői eszközök for Windows Mixed Reality telepítésének legegyszerűbb módja a Windows Eszközportál. Nyissa meg az "OpenXR" oldalt, majd kattintson a "Fejlesztői funkciók" alatt található "Telepítés" gombra, amely fizikai HoloLens 2 eszközön is működik.

OpenXR Fejlesztői eszközök alkalmazáshoz Windows Mixed Reality openXR-alkalmazás

Az OpenXR API és a mintaalkalmazás felfedezése

Ha még nem, telepítse az OpenXR-fejlesztéshez szükséges eszközöket.

A BasicXrApp projekt egy egyszerű OpenXR-mintát mutat be Win32 és UWP HoloLens 2 projektfájlt tartalmaz a Visual Studio. Mivel a megoldás egy HoloLens UWP-projektet tartalmaz, a Universal Windows Platform fejlesztési számítási feladatának telepítése szükséges a Visual Studio annak teljes megnyitásához.

Bár a Win32- és UWP-projektfájlok a csomagolás és az üzembe helyezés közötti különbségek miatt elkülönülnek, az egyes projekteken belüli alkalmazáskódok szinte teljesen azonosak!

Az OpenXR-alkalmazás futtatása

Az OpenXR Win32 asztali .EXE kiépítése után bármely, az OpenXR-t támogató asztali VR-platformon használhatja VR-headsettel, a headset típusától függetlenül.

Az OpenXR UWP-alkalmazáscsomagok kiépítése után a csomagot üzembe helyezheti egy HoloLens 2-es vagy 2-es HoloLens-eszközön Emulator.

Tanulás OpenXR API használata

Az OpenXR API bemutatóját ebben a 60 perces videóban, amely a BasicXrApp mintát Visual Studio. A videó bemutatja, hogyan használhatók az OpenXR API főbb összetevői a saját motorban, valamint bemutat néhányat az OpenXR-alapú alkalmazásokból:

OpenXR használata meglévő projektben

Az OpenXR meglévő projektben való elkezdéséhez be kell szereznie az OpenXR betöltőt. A betöltő felderíti az aktív OpenXR-runtime-t az eszközön, és hozzáférést biztosít az alapvető funkciókhoz és bővítményfunkciókhoz, amelyek implementálói.

Hivatkozhat a hivatalos OpenXR NuGet-csomagra a Visual Studio-projektből, vagy felhasználhatja a Khronos-GitHub hivatalos OpenXR betöltőforrását. Mindkét módszer hozzáférést biztosít az OpenXR 1.0 alapvető funkcióihoz, valamint a közzétett KHR , EXT és MSFT bővítményekhez.

Ha a bővítményekkel is kísérletezni szeretne, az előzetes verziójú OpenXR-fejléceket a Mixed Reality GitHub MSFT_preview másolhatja. MSFT_preview

Referencia a hivatalos OpenXR NuGet-csomagra

Az OpenXR.Loader NuGet-csomag a legegyszerűbben egy előre összeállított OpenXR betöltő .DLL hivatkozhat az Visual Studio C++ megoldásban. Ez hozzáférést biztosít az OpenXR 1.0 alapvető funkcióihoz, valamint a közzétett KHR , EXT és MSFT bővítményekhez.

OpenXR.Loader NuGet-csomaghivatkozás hozzáadása a C++ Visual Studio megoldáshoz:

  1. A Megoldáskezelőkattintson a jobb gombbal az OpenXR-t használni kívánt projektre, és válassza a Manage NuGet Packages... (NuGet-csomagok kezelése... ) lehetőséget.
  2. Váltson a Browse (Tallózás) lapra, és keressen rá az OpenXR.Loader kifejezésre.
  3. Válassza ki az OpenXR.Loader csomagot, és válassza a telepítés lehetőséget a jobb oldali részletező panelen.
  4. Kattintson az OK gombra a projekt módosításainak elfogadásához.
  5. Az OpenXR API használatának elkezdéshez adja hozzá a adatokat #include <openxr/openxr.h> egy forrásfájlhoz.

Az OpenXR API-t a BasicXrApp mintaalkalmazásban láthatja.

Hivatalos OpenXR-betöltőforrás

Ha saját maga szeretné felépíteni a betöltőt, például hogy elkerülje a felesleges .DLL, a hivatalos Khronos OpenXR betöltőforrásokat is be lehet húzni a projektbe. Ez hozzáférést biztosít az OpenXR 1.0 alapvető funkcióihoz, valamint a közzétett KHR , EXT és MSFT bővítményekhez.

Első lépésként kövesse a Következő oldalon található Khronos OpenXR-SDK-GitHub. A projekt úgy van beállítva, hogy a CMake használatával buildelje a projektet – ha az MSBuildet használja, a kódot a saját projektjére kell másolnia.

Előzetes verziójú bővítmények használata

A bővítmény ütemtervében felsorolt bővítmények kísérleti szállítói bővítmények, amelyek előzetes verzióban adatokat MSFT_preview gyűjtenek a visszajelzések MSFT_preview gyűjtése érdekében. Ezek a bővítmények csak fejlesztői eszközökre használhatók, és a valódi bővítmény terjesztéskor el lesznek távolítva.

Ha ki szeretne próbálni egy elérhető bővítményt, kövesse az alábbi lépéseket MSFT_preview a projekt frissítéséhez:

  1. A fenti módszerek bármelyikével integrálhatja az OpenXR betöltőt a projektbe.
  2. Cserélje le a projektben található szabványos OpenXR-fejléceket a Mixed Reality OpenXR-GitHub.

Az előzetes verziójú bővítmény támogatásának aktiválása a 2 HoloLens asztali számítógépen:

  1. Annak érdekében, hogy biztosan a legújabb OpenXR-runtime legyen elérhető az összes bővítménysel, indítsa el az Áruház alkalmazást a céleszközön vagy az emulátoron belül, nyissa meg a jobb felső menüt, válassza a Letöltések és frissítések lehetőséget, és válassza a Frissítések letöltése lehetőséget.
  2. Telepítse az OpenXR Fejlesztői eszközök for Windows Mixed Reality alkalmazást a Microsoft Store a céleszközre, és futtassa.
  3. Lépjen a Fejlesztői Gépház lapra, és engedélyezze a Use latest preview OpenXR runtime (A legújabb előzetes verziójú OpenXR-futtatás használata) jelölőnégyzetet. Ez engedélyezi az előzetes verziójú futásidőt az eszközön, amelyen aktiválva vannak az előzetes verziójú bővítmények. OpenXR Fejlesztői eszközök for Windows Mixed Reality Developer Gépház lap
  4. Győződjön meg arról, hogy az OpenXR Fejlesztői eszközök for Windows Mixed Reality Rendszerállapot lapján látható futásidejű verzió megegyezik a kipróbálni kívánt előzetes verziójú bővítmények szükséges verziójával. Ha igen, a bővítmény megjelenik a Bővítmények listában. Amint elérhetővé válik egy stabil bővítmény, az előzetes verziójú bővítménye el lesz távolítva.
    OpenXR Fejlesztői eszközök alkalmazás Windows Mixed Reality rendszerállapot lapja

Az Mixed Reality bővítmények dokumentációját és a használatuk mintáit az OpenXR-kódtáraban találhatja meg.

Hibaelhárítás

Ha nem tudja elhozni az OpenXR-fejlesztést, tekintse meg a hibaelhárítási tippeket.