Rychlý Start: nasazení ukázky nativního C++ WMR do HoloLens

v tomto rychlém startu se dozvíte, jak nasadit a spustit nativní výukovou aplikaci C++ WMR (Windows Mixed Reality) na HoloLens 2.

V tomto rychlém startu se naučíte:

Požadavky

Pokud chcete získat přístup ke službě vzdáleného vykreslování Azure, musíte nejdřív vytvořit účet.

Musí být nainstalovaný následující software:

• Windows SDK 10.0.18362.0 (stáhnout)
• nejnovější verze Visual Studio 2019 (stažení)
• Visual Studio nástroje pro Mixed reality. Konkrétně jsou nutné následující instalace úloh :
  • Vývoj desktopových aplikací v C++
  • vývoj Univerzální platforma Windows (UWP)
• GIT (Stáhnout)

Naklonujte úložiště ukázek ARR.

Jako první krok naklonujte úložiště Git, které je součástí globálních ukázek pro vzdálené vykreslování Azure. otevřete příkazový řádek (typ cmd v nabídce start Windows) a přejděte do adresáře, kam chcete uložit vzorový projekt ARR.

Spusťte následující příkazy:

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

Poslední příkaz vytvoří podadresář v adresáři ARR, který obsahuje různé ukázkové projekty pro vzdálené vykreslování Azure.

kurz HoloLens jazyka C++ najdete v podadresáři NativeCpp/HoloLens-Wmr.

Sestavení projektu

otevřete soubor řešení HolographicApp. sln umístěný v podadresáři NativeCpp/HoloLens-Wmr s Visual Studio 2019.

Přepněte konfiguraci buildu na Debug (nebo release) a ARM64. Také se ujistěte, že je režim ladicího programu nastavený na zařízení na rozdíl od vzdáleného počítače:

Vzhledem k tomu, že přihlašovací údaje účtu jsou pevně zakódované ve zdrojovém kódu kurzu, změňte je na platné přihlašovací údaje. v takovém případě otevřete soubor HolographicAppMain.cpp v Visual Studio a změňte část, kde je klient vytvořen v konstruktoru třídy HolographicAppMain :

// 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));
}

Konkrétně změňte následující hodnoty:

• init.AccountId, init.AccountKey a init.AccountDomain pro použití dat vašeho účtu. Přečtěte si článek o tom, jak načíst informace o účtu.
• Určete, kde vytvořit relaci vzdáleného vykreslování změnou části oblasti v init.RemoteRenderingDomain řetězci pro jiné oblasti westus2 , než je třeba "westeurope.mixedreality.azure.com" .
• Kromě toho se m_sessionOverride dá změnit na existující ID relace. Relace je možné vytvořit mimo tuto ukázku, například pomocí skriptu PowerShellu nebo přímo pomocí REST API relace . Vytvoření relace mimo ukázku se doporučuje, když by se vzorek spouštěl víckrát. Pokud není předána žádná relace, ukázka při každém spuštění vytvoří novou relaci, která může trvat několik minut.

Nyní může být aplikace zkompilována.

Spuštění aplikace

1. Připojte HoloLens k počítači pomocí kabelu USB.
2. zapněte HoloLens a počkejte, než se zobrazí nabídka start.
3. Ve Visual Studiu spusťte ladicí program (F5). Ten automaticky nasadí aplikaci do zařízení.

Ukázková aplikace by se měla spustit a zobrazí se textový panel, který vás informuje o aktuálním stavu aplikace. Stav při spuštění je buď spuštění nové relace, nebo připojení k existující relaci. Po dokončení načítání modelu se vestavěný model motoru zobrazí přímo na pozici hlavního panelu. Překrytí model modulu pracuje správně s otáčející se datovou krychlí, která je vykreslena místně.

pokud chcete ukázku spustit později později, můžete ji také najít z nabídky HoloLens start, ale všimněte si, že do ní může být zkompilováno ID relace s vypršenou platností.

Další kroky

Tento rychlý Start je založený na výsledku kurzu, který vysvětluje, jak integrovat všechny části související se vzdáleným vykreslováním do burzovní holografické aplikace. Postup, který je potřeba, najdete v tomto kurzu: