Megosztás a következőn keresztül:

Új OpenXR-projekt beállítása MRTK nélkül

  • Cikk

Bár a Microsoft és a közösség olyan nyílt forráskód eszközöket hozott létre, mint például a Mixed Reality Eszközkészlet (MRTK), amely automatikusan beállítja a környezetet a vegyes valósághoz, egyes fejlesztők az alapoktól kezdve szeretnék felépíteni a tapasztalataikat.

Egyéb nem OpenXR-konfigurációs lehetőségek, amelyeket érdemes figyelembe venni

Windows XR: A Microsoft nem javasolja a Windows XR beépülő modul használatát a Unity 2020 új projektjeihez. Ehelyett az Mixed Reality OpenXR beépülő modult kell használnia. Ha azonban a Unity 2019-et használja, és az AR Foundation 2.0-ra van szüksége az ARCore/ARKit-eszközökkel való kompatibilitáshoz, ez a beépülő modul lehetővé teszi ezt a támogatást.

Fontos

A Unity 2019 beépülő modul használata nem kompatibilis az Azure Spatial Anchors szolgáltatással.

Örökölt XR:

Ha továbbra is a Unity 2019-es vagy korábbi verziót használja, a Microsoft az örökölt beépített XR-támogatás használatát javasolja. Bár a Windows XR beépülő modul működik a Unity 2019-ben, nem javasoljuk, mert nem kompatibilis a Unity 2019-ben futó Azure Spatial Anchors szolgáltatással.

Ha új projektet kezd, javasoljuk, hogy inkább a Unity 2020-t telepítse, és használja az Mixed Reality OpenXR beépülő modult.

Az OpenXR használatának első lépései: Új Unity-projekt létrehozása

  1. Indítsa el a Unity Hubot.

  2. A Projektek lapon kattintson az Új projekt elemre.

    Képernyőkép a Unity Hub a Projektek lapon az Új projekt gomb kiemelésével.

  3. Kattintson az Új projekt alatti legördülő listára, majd válassza ki a kívánt Szerkesztőverziót.

    Képernyőkép a Unity Hubról, amelyen megjelenik a Szerkesztő verziója legördülő lista.

  4. Győződjön meg arról, hogy a kiválasztott sablon 3D Core.

  5. A Projekt neve mezőbe írja be a projekt nevét – például "MRTK-oktatóanyag".

  6. A Hely mezőben kattintson a mappa ikonra, majd keresse meg azt a mappát, ahová menteni szeretné a projektet, és jelölje ki. Új mappát is létrehozhat.

    Képernyőkép a Unity Hubról a 3D, a Projekt neve, a Hely és a Létrehozás elem kiemelésével.

  7. Kattintson a Create Project (Projekt létrehozása) elemre. Ez megnyitja a projektet a Unityben.

    Képernyőkép a Unityben megnyitott projektről.

Figyelemfelhívás

Ha Windows rendszerben dolgozik, akkor a MAX_PATH értéke nem lehet hosszabb 255 karakteresnél. A Unityt érintik ezek a korlátok, és előfordulhat, hogy nem tudja feldolgozni az adatokat, ha bármely fájl elérési útvonala hosszabb 255 karakteresnél. Ezért javasoljuk, hogy a Unity-projektet a lehető legközelebb tárolja a meghajtó gyökeréhez.

A buildcél beállítása

  1. A menüsávon válassza a Fájl>buildelési beállításai... lehetőséget.

    Ahhoz, hogy Windows Mixed Reality alkalmazásokat hozzon létre, ki kell választania egy buildcélt. A Univerzális Windows-platform (UWP) buildbeállításai bármilyen eszközt megcélznak, beleértve a modern headseteket, például a HP Reverb G2-t. Ez a legjobb választás, ha a HoloLens 2 készít; ha azonban asztali VR-t céloz meg, javasoljuk, hogy a PC, a Mac & Linux önálló platformot használja.

  2. Tegye a következők egyikét:

    Ha asztali VR-t céloz meg:

    • Tartsa meg a pc-s, Mac & önálló Linux platformot, amely alapértelmezés szerint egy új Unity-projektben van kiválasztva:

    Képernyőkép a Build Settings ablakról, amely a unity szerkesztőben nyílik meg pc-vel, Mac & önálló platform kiemelve

    Ha a HoloLens 2 céloz meg:

    • A Platform területen válassza a Univerzális Windows-platform lehetőséget. Győződjön meg arról, hogy a következő beállítások aktívak:

    Build típusa: D3D-projekt

    Cél SDK-verzió: Legújabb telepítve

    Minimális platformverzió: 10.0.10240.0

    Visual Studio-verzió: Legújabb telepítve

    Képernyőkép a Build Settings ablakról, amely meg van nyitva a unity szerkesztőben, Univerzális Windows-platform kiemelve.

  3. Kattintson a Platformváltás gombra. A Unity egy folyamatjelző sávot jelenít meg, miközben a platformokat váltja.

  4. A platformváltási folyamat befejezése után zárja be a Build Settings (Létrehozási beállítások ) ablakot.

A Mixed Reality szolgáltatás eszköz letöltése és telepítése

A Mixed Reality OpenXR beépülő modul egy Unity-csomag formájában jelenik meg. A szolgáltatáscsomagok felderítésének, frissítésének és importálásának legjobb módja a Mixed Reality funkcióeszköz. A csomagok között név vagy kategória szerint kereshet, megtekintheti azok függőségeit, és az importálás előtt megtekintheti a projekt jegyzékfájljának javasolt módosításait.

  1. Töltse le a Mixed Reality funkcióeszköz legújabb verzióját a Microsoft letöltőközpontból.

  2. A letöltés befejezése után keresse meg a végrehajtható fájlt MixedRealityFeatureTool.exe, majd a használatával indítsa el a Mixed Reality funkcióeszközt.

    Képernyőkép a MixedRealityFeatureTool megnyitásáról.

Az Mixed Reality OpenXR beépülő modul importálása

  1. A Mixed Reality funkcióeszközben válassza a Start gombot.

    Képernyőkép a Mixed Reality funkcióeszköz nyitóképernyőéről.

  2. Válassza a Tallózás gombot (ez az alábbi képen a "három pont" gomb), majd keresse meg a Unity-projektet tartalmazó mappát, és nyissa meg.

    A projekt megnyitása

    Megjegyzés

    Az eszköz Projektútvonal mezőjének tartalmaznia kell valamilyen értéket, ezért alapértelmezés szerint fordított perjelet ("_") szúr be.

    Miután kiválasztott egy mappát, az eszköz ellenőrzi, hogy érvényes Unity-projektmappa-e.

    Képernyőkép a Mixed Reality funkció Eszközprojekt elérési útja képernyőről.

  3. Válassza a Szolgáltatások felderítése lehetőséget.

    Megjegyzés: Előfordulhat, hogy várnia kell néhány másodpercet, amíg az eszköz frissíti a csomagokat a hírcsatornákból.

  4. A Szolgáltatások felderítése lapon vegye figyelembe, hogy hat csomagcsoportot tartalmaz.

    A Mixed Reality szolgáltatáseszköz csomagjainak fő csoportjai

  5. Kattintson a platformtámogatástól balra található "+" gombra (5-ből 0), majd válassza ki a Mixed Reality OpenXR beépülő modul legújabb verzióját.

    Képernyőkép a Mixed Reality funkcióeszköz csomagkijelöléséről.

  6. Miután kiválasztotta(k) a elemet, kattintson a Szolgáltatások lekérése elemre.

  7. Válassza az Ellenőrzés lehetőséget a kiválasztott csomagok érvényesítéséhez. Meg kell jelennie egy párbeszédpanelnek, amely azt jelzi, hogy Nem észleltek érvényesítési problémákat. Ha igen, kattintson az OK gombra.

  8. Az Import Features (Szolgáltatások importálása ) lapon a bal oldali , Szolgáltatások oszlop megjeleníti az imént kiválasztott csomagokat. A jobb oldali, Kötelező függőségek oszlop megjeleníti a függőségeket. Ezekről az elemekről a Részletek hivatkozásra kattintva tudhat meg többet.

  9. Ha készen áll a továbblépésre, válassza az Importálás lehetőséget. A Véleményezés és jóváhagyás lapon áttekintheti a csomagokkal kapcsolatos információkat.

  10. Válassza a Jóváhagyás lehetőséget.

  11. Térjen vissza a Unity-szerkesztőhöz, és kattintson egy üres területre a felhasználói felületen. Megjelenik egy folyamatjelző sáv, amelyen látható, hogy a csomag importálása folyamatban van.

Bemeneti háttérbeállítások konfigurálása

  1. Miután a Unity importálta a csomagot, megjelenik egy figyelmeztetés, amely megkérdezi, hogy szeretné-e engedélyezni a háttérrendszereket a szerkesztő újraindításával. Válassza az Igen lehetőséget.

    Képernyőkép a Unity újraindítási lehetőségéről.

A projekt konfigurálása a HoloLens 2 projektérvényesítéssel (MR OpenXR 1.6+)

Ha asztali VR-ra fejleszt, hagyja ki ezt a szakaszt, és válassza a Projekt konfigurálása asztali VR-hoz című szakaszt.

  1. A menüsávon kattintson Mixed Reality > Projektérvényesítési beállítások > HoloLens 2 Alkalmazás (UWP) elemre az HoloLens 2 érvényesítési szabályainak engedélyezéséhez. Az 1.9-es verzió előtti MR OpenXR beépülő modulok esetében a rendelkezésre álló menüelem Mixed Reality > Project > Apply recommended project settings for HoloLens 2.
  2. Az előugró projektérvényesítési ablakban győződjön meg arról, hogy az UWP platform lapján van (ezt a Windows embléma jelzi), majd kattintson az Összes javítása elemre az érvényesítési problémák megoldásához. Vegye figyelembe, hogy előfordulhatnak olyan problémák, amelyek az Összes javítása gombra kattintás után is fennállhatnak. Ebben az esetben próbálja meg ismét a Javítás gombra kattintani, hagyja figyelmen kívül a "jelenetspecifikus" (ha vannak) jelölésű problémákat, és tekintse át a többi problémát (ha van ilyen), és ellenőrizze, hogy vannak-e javasolt módosítások.
  3. A projekt ekkor már majdnem készen áll HoloLens 2 üzembe helyezésre. Folytassa a Következő lépés lejátszóbeállításainak konfigurálásával .

A projekt konfigurálása a HoloLens 2 manuálisan

Ha asztali VR-ra fejleszt, hagyja ki ezt a szakaszt, és válassza a Projekt konfigurálása asztali VR-hoz című szakaszt.

  1. Győződjön meg arról, hogy a Projektbeállítások ablak meg van nyitva. Ha nem, a menüsávon válassza aProjektbeállításokszerkesztése> lehetőséget.

  2. A Projektbeállítások ablakban győződjön meg arról, hogy az XR beépülő modul kezelése lapon és a Univerzális Windows-platform lapon található.

    Képernyőkép a Projektbeállítások ablakról, amely meg van nyitva az XR beépülő modul felügyeleti lapjára és Univerzális Windows-platform fülre.

  3. Győződjön meg arról, hogy az XR inicializálása indításkor beállítás be van jelölve, majd a Beépülő modulok szolgáltatói területen kattintson az OpenXR elemre.

    Képernyőkép a Projektbeállítások ablakról a Univerzális Windows-platform belül, amelyen az XR inicializálása indításkor lehetőség van kijelölve, és az OpenXR beépülő modul ki van emelve.

  4. Az OpenXR beépülő modul betöltődik, majd több elem jelenik meg az OpenXR alatt. Válassza Microsoft HoloLens funkciócsoportot.

    Képernyőkép a Projektbeállítások ablakról az OpenXR beépülő modullal és a Microsoft HoloLens szolgáltatáscsoport kiemelésével.

Vegye figyelembe, hogy az OpenXR mellett egy sárga figyelmeztető háromszög található. Ez azt jelzi, hogy nem kompatibilis beállításokkal rendelkezik, amelyeket fel kell oldani. A probléma megoldásához hagyja ki a VR-konfigurálásról szóló következő szakaszt, és folytassa a következő, Nem kompatibilis beállítások feloldása című szakaszával.

A projekt konfigurálása asztali VR-ra projektérvényesítéssel (MR OpenXR 1.9+)

  1. A menüsávon kattintson Mixed Reality > Project Validation Settings > Win32 Application (Önálló) elemre az asztali XR-alkalmazások érvényesítési szabályainak engedélyezéséhez.
  2. Az előugró projektérvényesítési ablakban győződjön meg arról, hogy az Önálló platform lapon van, és kattintson az Összes javítása elemre az érvényesítési problémák megoldásához. Vegye figyelembe, hogy előfordulhatnak olyan problémák, amelyek az Összes javítása gombra kattintás után is fennállhatnak. Ebben az esetben próbálja meg ismét a Javítás gombra kattintani, hagyja figyelmen kívül a "jelenetspecifikus" (ha vannak) jelölésű problémákat, és tekintse át a többi problémát (ha van ilyen), és ellenőrizze, hogy vannak-e javasolt módosítások.

A projekt konfigurálása asztali VR-hoz manuálisan

  1. Győződjön meg arról, hogy a Projektbeállítások ablak meg van nyitva. Ha nem, lépjen a menüsávra, és válassza aProjektbeállításokszerkesztése> lehetőséget.

  2. A Project Settings (Projektbeállítások ) ablakban győződjön meg arról, hogy az XR beépülő modul kezelése lapon, illetve a PC,Mac & Önálló Linux lapon található.

    Képernyőkép a Projektbeállítások ablakról, amely meg van nyitva az XR beépülő modul kezelőlapján és a PC-n, a Mac & Önálló Linux lapon.

  3. Győződjön meg arról, hogy az XR inicializálása indításkor beállítás be van jelölve, majd a Beépülő modulok szolgáltatói területen kattintson az OpenXR elemre.

    Képernyőkép a Projektbeállítások ablakról a PC-n belül, a Mac & Linux önálló lapján, amelyen az XR inicializálása indításkor lehetőség van kiválasztva, és az OpenXR beépülő modul ki van emelve.

  4. Az OpenXR beépülő modul betöltődik, majd két elem jelenik meg az OpenXR alatt. Válassza ki az első, Windows Mixed Reality funkciócsoportot.

    Képernyőkép a Projektbeállítások ablakról, amelyben az OpenXR beépülő modul és Windows Mixed Reality szolgáltatáscsoport ki van emelve.

Vegye figyelembe, hogy az OpenXR mellett egy sárga figyelmeztető háromszög látható. Ez azt jelzi, hogy nem kompatibilis beállításokkal rendelkezik, amelyeket fel kell oldani. A probléma megoldásához folytassa a következő, Nem kompatibilis beállítások feloldása című szakaszsal.

Nem kompatibilis beállítások feloldása

Fontos

Az ebben a szakaszban található képeken a Univerzális Windows-platform lapon található beállítások láthatók. Az asztali VR lapra vonatkozó utasítások azonban megegyeznek, kivéve, ha fel vannak jegyezve.

  1. Vigye a kurzort az OpenXR melletti sárga figyelmeztető háromszög fölé, majd olvassa el az üzenetet az előugró ablakban, majd jelölje ki a háromszöget.

    Képernyőkép a nem kompatibilis beállításokra vonatkozó figyelmeztetésről.

  2. Az OpenXR projektérvényesítési ablakban több probléma is szerepel. Válassza az Összes javítása gombot. MEGJEGYZÉS: Ez a lista attól függően eltérő lehet, hogy melyik lapon van.

    Képernyőkép az OpenXR Projektérvényesítés ablak Minden javítás gombjáról.

  3. Az egyik probléma továbbra is fennáll, és azt jelzi, hogy legalább egy interakciós profilt hozzá kell adnia. Ehhez kattintson a Szerkesztés gombra. Ez a Projektbeállítások ablak OpenXR beépülő moduljának beállításait nyitja meg.

    Képernyőkép a Projektbeállítások ablakról az OpenXR-beállítások megjelenítésével.

  4. Az Interakciós profilok alatt jegyezze fel a pluszjel (+) gombot.

    Képernyőkép az Interakcióprofil hozzáadása gombról.

  5. Kattintson háromszor a gombra, minden alkalommal, amikor másik profilt választ:

    Szem tekintete interakciós profil

    Microsoft Hand Interaction-profil

    Microsoft Motion Controller-profil

    A hozzáadni kívánt interakciós profilok képernyőképe.

    Ha a Szempillantás interakciós profil vagy bármely más profil sárga háromszöggel jelenik meg mellette, jelölje ki a háromszöget, majd az OpenXR Projektérvényesítés ablakban kattintson a Javítás gombra. Ha végzett, zárja be az OpenXR Projektérvényesítés ablakot.

    Képernyőkép a Szem tekintete interakciós profil Javítás gombjáról.

  6. Győződjön meg arról, hogy a Projektbeállítások ablak OpenXR-szolgáltatáscsoportok területén a következők vannak kiválasztva:

    Ha az Asztali VR lapon van:

    Windows Mixed Reality

    Kézkövetés

    Mozgásvezérlő modell

    Képernyőkép az Asztali VR lap OpenXR-funkciócsoportjairól.

    Ha a Univerzális Windows-platform lapon van:

    Microsoft HoloLens

    Kézkövetés

    Mozgásvezérlő modell

    Képernyőkép az OpenXR kiválasztott funkcióiról.

  7. Kattintson a Mélységbeküldési mód legördülő listára, majd válassza a Mélység 16 bites lehetőséget.

    Képernyőkép a mélységi beküldési módhoz kiválasztott 16 bites mélységről.

    Tipp

    A mélységi formátum 16 bitesre csökkentése nem kötelező, de javíthatja a grafikus teljesítményt a projektben. További információ: Mélységi puffermegosztás (HoloLens).

    Megjegyzés

    A Leképezési mód beállítás, amely közvetlenül a Mélységi beküldési mód felett található, alapértelmezés szerint egybemenő példányra van állítva. Vegyes valósági alkalmazásokban a jelenet kétszer jelenik meg: minden szemhez egyszer. Az eredmény a "sztereoszkopikus látás". Ez megduplázza a szükséges számításmennyiséget, ezért fontos, hogy a Unityben a leghatékonyabb megjelenítési útvonalat választva a cpu- és GPU-időt is megtakaríthassa. Itt az egybemenős példányos megjelenítés a legjobb választás – javasoljuk, hogy minden projekt esetében alapértelmezés szerint engedélyezze. Erről további információt a Unity dokumentációjában talál.

Lejátszóbeállítások konfigurálása

  1. A Projektbeállítások ablak bal oldali oszlopában válassza a Lejátszó lehetőséget.

  2. Vegye figyelembe, hogy a Lejátszó ablakban a Terméknév mező már ki van töltve. Ez a projekt nevéből származik, és a HoloLens Start menüben megjelenő név lesz.

    Képernyőkép a Unity közzétételi beállításairól a Projektnév mező kitöltésével.

    Tipp

    Annak érdekében, hogy az alkalmazás könnyebben megtalálható legyen a fejlesztés során, adjon hozzá egy aláhúzást a név elé, hogy a lista tetejére rendezze.

  3. Kattintson a Közzétételi beállítások legördülő listára, majd a Csomagnév mezőbe írja be a megfelelő nevet.

    Képernyőkép a Unity közzétételi beállításairól a csomagnév mező kitöltésével.

    Megjegyzés

    A csomag neve az alkalmazás egyedi azonosítója. Ha el szeretné kerülni az alkalmazás korábban telepített verzióinak felülírását ugyanazzal a névvel, az alkalmazás üzembe helyezése előtt módosítania kell ezt az azonosítót.

  4. Zárja be a Projektbeállítások ablakot.

Most már készen áll arra, hogy megkezdje a fejlesztést az OpenXR használatával a Unityben!

Unity-mintaprojektek

Tekintse meg az OpenXR Mixed Reality mintaadattárat unity-mintaprojektekhez, amelyek bemutatják, hogyan hozhat létre Unity-alkalmazásokat HoloLens 2 vagy Mixed Reality headsetekhez az Mixed Reality OpenXR beépülő modullal.

Lásd még