Rychlý start: Nasazení nativní ukázky služby WMR C++ do HoloLens

Článek
05/30/2024

Tento rychlý start popisuje, jak nasadit a spustit nativní aplikaci kurzu C++ windows Mixed Reality (WMR) na HoloLens 2.

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

Sestavte aplikaci kurzu pro HoloLens.
Změňte přihlašovací údaje azure Remote Renderingu ve zdrojovém kódu.
Nasaďte a spusťte ukázku na zařízení.

Požadavky

Pokud chcete získat přístup ke službě Vzdálené vykreslování, musíte nejprve vytvořit účet.

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

Windows SDK 10.0.18362.0 nebo novější
Nejnovější verze sady Visual Studio 2022.
Nástroje sady Visual Studio pro hybridní realitu Konkrétně se vyžadují následující instalace úloh :
- Vývoj desktopových aplikací pomocí jazyka C++
- vývoj pro Univerzální platforma Windows (UPW)
Git
Modul plug-in Git LFS

Klonování úložiště ukázek vzdáleného vykreslování

Jako první krok naklonujte úložiště Git, které obsahuje globální ukázky Azure Remote Renderingu. Zadáním cmd windows nabídka Start otevřete okno příkazového řádku. Přejděte do adresáře, do kterého chcete uložit ukázkový 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ří složku ve složce ARR, která obsahuje různé ukázkové projekty pro Azure Remote Rendering.

Kurz jazyka C++ HoloLens najdete ve složce NativeCpp/HoloLens-Wmr.

Sestavení projektu

Otevřete soubor řešení HolographicApp.sln umístěný ve složce NativeCpp/HoloLens-Wmr pomocí sady Visual Studio.

Přepněte konfiguraci sestavení na ladění (nebo vydání) a ARM64. Ujistěte se, že je režim ladicího programu nastavený na zařízení na rozdíl od vzdáleného počítače:

Snímek obrazovky znázorňující oblast konfigurace sady Visual Studio s hodnotami, jak je popsáno

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. Otevřete soubor HolographicAppMain.cpp v sadě Visual Studio a změňte část, ve které je klient vytvořen uvnitř 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.AccountIdinit.AccountDomain a init.AccountKeyk používání dat účtu. Přečtěte si část o tom, jak načíst informace o účtu.
Určete, kde se má vytvořit relace vzdáleného vykreslování úpravou části init.RemoteRenderingDomain oblasti řetězce pro jiné oblasti než westus2, například "westeurope.mixedreality.azure.com".
Kromě toho m_sessionOverride je možné změnit na existující ID relace. Relace lze vytvořit mimo tuto ukázku. Další informace naleznete v tématu RenderingSession.ps1 nebo použití rozhraní REST API pro správu relací přímo.

Vytvoření relace mimo ukázku se doporučuje, když se má ukázka spustit vícekrát. Pokud se žádná relace nepředá, ukázka vytvoří relaci při každém spuštění, což může trvat několik minut.

Teď můžete aplikaci zkompilovat.

Spustí aplikaci.

Připojte HoloLens k počítači pomocí kabelu USB.
Zapněte HoloLens a počkejte, až se zobrazí nabídka Start.
Ve Visual Studiu spusťte ladicí program (F5). Aplikace se automaticky nasadí do zařízení.

Spustí se ukázková aplikace a zobrazí se textový panel, který vás informuje o aktuálním stavu aplikace. Stav při spuštění buď spouští novou relaci, nebo se připojuje k existující relaci. Po dokončení načítání modelu se integrovaný model motoru zobrazí přímo na pozici hlavy. Model motoru správně komunikuje s rotující datovou krychlí, která se vykresluje místně.

Pokud chcete ukázku spustit znovu později, najdete ji také v nabídce Start HoloLens. Může mít zkompilované ID relace s vypršenou platností.

Další kroky

Tento rychlý start vychází z výsledku kurzu, který vysvětluje, jak integrovat všechny části související se vzdáleným vykreslováním do skladové holografické aplikace. Pokud chcete zjistit, které kroky jsou nezbytné, postupujte podle tohoto kurzu:

Kurz: Integrace vzdáleného vykreslování do holografické aplikace HoloLens

Sdílet prostřednictvím