Rövid útmutató: Natív C++ WMR-minta üzembe helyezése a HoloLensben

Ez a rövid útmutató bemutatja, hogyan helyezheti üzembe és futtathatja a natív C++ Windows Mixed Reality (WMR) oktatóanyag-alkalmazást egy HoloLens 2-en.

Ebben a rövid útmutatóban megtanulhatja, hogyan:

• Hozza létre a HoloLens oktatóalkalmazását.
• Módosítsa az Azure Remote Rendering hitelesítő adatait a forráskódban.
• Telepítse és futtassa a mintát az eszközön.

Előfeltételek

A távoli renderelési szolgáltatáshoz való hozzáféréshez először létre kell hoznia egy fiókot.

A következő szoftvert kell telepíteni:

• Windows SDK 10.0.18362.0 vagy újabb.
• A Visual Studio 2022 legújabb verziója.
• Visual Studio-eszközök vegyes valósághoz. Konkrétan a következő számítási feladatok telepítésére van szükség:
  • Asztali fejlesztés a C++ használatával
  • Univerzális Windows-platform (UWP) fejlesztése
• Git.
• Git LFS beépülő modul

A távoli renderelési minták adattárának klónozása

Első lépésként klónozza a Git-adattárat, amely a globális Azure Remote Rendering-mintákat jeleníti meg. Írja be cmd a Windows Start menüjét egy parancssori ablak megnyitásához. Váltson olyan könyvtárra, amelyben tárolni szeretné az ARR-mintaprojektet.

Futtassa az alábbi parancsot:

Windows Command Prompt

mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering

Az utolsó parancs létrehoz egy mappát az ARR mappában, amely az Azure Remote Rendering különböző mintaprojekteit tartalmazza.

A C++ HoloLens oktatóanyag a NativeCpp/HoloLens-Wmr mappában található.

A projekt felépítése

Nyissa meg a Visual Studióval a NativeCpp/HoloLens-Wmr mappában található HolographicApp.sln megoldásfájlt.

Állítsa át a buildkonfigurációt hibakeresésre (vagy kiadásra) és ARM64-re. Győződjön meg arról, hogy a hibakereső mód eszközre van állítva a távoli gép helyett:

Mivel a fiók hitelesítő adatai az oktatóanyag forráskódjában vannak kódolva, módosítsa őket érvényes hitelesítő adatokra. Nyissa meg a fájlt HolographicAppMain.cpp a Visual Studióban, és módosítsa azt a részt, amelyben az ügyfél létrejön az osztály HolographicAppMainkonstruktorában:

C++

// 2. Create Client
{
    // Users need to fill out the following with their account data and model
    RR::SessionConfiguration init;
    init.AccountId = "00000000-0000-0000-0000-000000000000";
    init.AccountKey = "<account key>";
    init.RemoteRenderingDomain = "westus2.mixedreality.azure.com"; // <change to the region that the rendering session should be created in>
    init.AccountDomain = "westus2.mixedreality.azure.com"; // <change to the region the account was created in>
    m_modelURI = "builtin://Engine";
    m_sessionOverride = ""; // If there is a valid session ID to re-use, put it here. Otherwise a new one is created
    m_client = RR::ApiHandle(RR::RemoteRenderingClient(init));
}

Pontosabban módosítsa a következő értékeket:

• init.AccountId, init.AccountKeyvalamint init.AccountDomain a fiókadatok használatához. Tekintse meg a fiókadatok lekérésének módját ismertető szakaszt.
• Adja meg, hogy hol hozza létre a távoli renderelési munkamenetet a sztring régiórészének init.RemoteRenderingDomain módosításával más régiók esetében, példáulwestus2"westeurope.mixedreality.azure.com".
• Emellett m_sessionOverride egy meglévő munkamenet-azonosítóra is módosítható. A munkamenetek ezen a mintán kívül hozhatók létre. További információ: RenderingSession.ps1 vagy A munkamenet-kezelési REST API közvetlen használata.

A mintán kívüli munkamenet létrehozása akkor ajánlott, ha a minta többször is futnia kell. Ha nem ad át munkamenetet, a minta minden indításkor létrehoz egy munkamenetet, ami több percet is igénybe vehet.

Most már lefordíthatja az alkalmazást.

Az alkalmazás indítása

1. Csatlakoztassa a HoloLenst a számítógépéhez egy USB-kábellel.
2. Kapcsolja be a HoloLenst, és várja meg, amíg megjelenik a start menü.
3. Indítsa el a hibakeresőt a Visual Studióban (F5). Automatikusan telepíti az alkalmazást az eszközön.

Ekkor elindul a mintaalkalmazás, és megjelenik egy szövegpanel, amely tájékoztatja az aktuális alkalmazásállapotról. Az állapot indításkor vagy új munkamenetet indít el, vagy egy meglévő munkamenethez csatlakozik. A modell betöltése után a beépített motormodell közvetlenül a fejpozícióban jelenik meg. Az occlusion-bölcs, a motormodell megfelelően működik együtt a helyben renderelt forgó kockával.

Ha később újra el szeretné indítani a mintát, a HoloLens start menüjében is megtalálhatja. Lehet, hogy lejárt munkamenet-azonosító van lefordítva.

Következő lépések

Ez a rövid útmutató egy oktatóanyag eredményén alapul, amely bemutatja, hogyan integrálható az összes távoli rendereléssel kapcsolatos darab egy részvény holografikus alkalmazásba. A szükséges lépések megismeréséhez kövesse ezt az oktatóanyagot:

Oktatóanyag: Távoli renderelés integrálása HoloLens Holographic-alkalmazásba