Snabbstart: Distribuera internt C++ WMR-exempel till HoloLens

Artikel
03/09/2023

Den här snabbstarten beskriver hur du distribuerar och kör det interna självstudieprogrammet C++ Windows Mixed Reality (WMR) på en HoloLens 2.

I den här snabbstarten lär du dig att:

Skapa självstudieprogrammet för HoloLens.
Ändra autentiseringsuppgifterna för Azure Remote Rendering i källkoden.
Distribuera och kör exemplet på enheten.

Förutsättningar

För att få åtkomst till Remote Rendering-tjänsten måste du först skapa ett konto.

Följande programvara måste installeras:

Windows SDK 10.0.18362.0 eller senare.
Den senaste versionen av Visual Studio 2022.
Visual Studio-verktyg för Mixed Reality. Mer specifikt krävs följande arbetsbelastningsinstallationer :
- Skrivbordsutveckling med C++
- utveckling av Universell Windows-plattform (UWP)
Git.
Git LFS-plugin-program

Klona lagringsplatsen Remote Rendering exempel

Som ett första steg klonar du Git-lagringsplatsen, som innehåller de globala Azure Remote Rendering-exemplen. Skriv cmd i Start-menyn i Windows för att öppna ett kommandotolksfönster. Ändra till en katalog där du vill lagra ARR-exempelprojektet.

Kör följande kommandon:

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

Det sista kommandot skapar en mapp i MAPPEN ARR som innehåller de olika exempelprojekten för Azure Remote Rendering.

Självstudien C++ HoloLens finns i mappen NativeCpp/HoloLens-Wmr.

Bygga projektet

Öppna lösningsfilen HolographicApp.sln som finns i mappen NativeCpp/HoloLens-Wmr med Visual Studio.

Växla build-konfigurationen till Debug (eller Release) och ARM64. Kontrollera att felsökningsläget är inställt på Enhet i stället för Fjärrdator:

Skärmbild som visar konfigurationsområdet för Visual Studio med värden enligt beskrivningen.

Eftersom autentiseringsuppgifterna för kontot är hårdkodade i självstudiekursens källkod ändrar du dem till giltiga autentiseringsuppgifter. Öppna filen HolographicAppMain.cpp i Visual Studio och ändra den del där klienten skapas i konstruktorn för klassen 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));
}

Mer specifikt ändrar du följande värden:

init.AccountId, init.AccountKeyoch init.AccountDomain för att använda dina kontodata. Se avsnittet om hur du hämtar kontoinformation.
Ange var du vill skapa fjärrrenderingssessionen genom att ändra regiondelen av strängen init.RemoteRenderingDomain för andra regioner än westus2, till exempel "westeurope.mixedreality.azure.com".
Kan dessutom m_sessionOverride ändras till ett befintligt sessions-ID. Sessioner kan skapas utanför det här exemplet. Mer information finns iRenderingSession.ps1 eller Använd REST API för sessionshantering direkt.

Vi rekommenderar att du skapar en session utanför exemplet när exemplet ska köras flera gånger. Om ingen session skickas skapar exemplet en session vid varje start, vilket kan ta flera minuter.

Nu kan du kompilera programmet.

Starta programmet

Anslut HoloLens med en USB-kabel till din dator.
Aktivera HoloLens och vänta tills Start-menyn visas.
Starta felsökningsprogrammet i Visual Studio (F5). Appen distribueras automatiskt till enheten.

Exempelappen startas och en textpanel visas som informerar dig om det aktuella programtillståndet. Statusen vid start startar antingen en ny session eller ansluter till en befintlig session. När modellinläsningen är klar visas den inbyggda motormodellen precis vid din huvudposition. Ocklusionsmässigt interagerar motormodellen korrekt med den snurrande kuben som återges lokalt.

Om du vill starta exemplet igen senare kan du också hitta det från Start-menyn i HoloLens. Det kan ha ett utgånget sessions-ID som kompilerats till det.

Nästa steg

Den här snabbstarten baseras på resultatet av en självstudie som förklarar hur du integrerar alla Remote Rendering relaterade delar i en holografisk app. Följ den här självstudien om du vill veta vilka steg som krävs:

Självstudie: Integrera Remote Rendering i en HoloLens Holographic-app

Share via