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

Artikel
05/30/2024

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 får du lära 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 fjärrrenderingstjä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 fjärrrenderingsexempel

Som ett första steg klonar du Git-lagringsplatsen, som innehåller de globala Azure Remote Rendering-exemplen. Skriv cmd in Windows-Start-menyn 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 ARR-mappen 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 finns i mappen NativeCpp/HoloLens-Wmr med Visual Studio.

Växla versionskonfigurationen till Felsök (eller Version) och ARM64. Kontrollera att felsökningsläget är inställt på Enhet i stället för Fjärrdator:

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

Eftersom kontoautentiseringsuppgifterna ä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 fjärrrenderingssessionen ska skapas genom att ändra regiondelen av strängen init.RemoteRenderingDomain för andra regioner än westus2, till exempel "westeurope.mixedreality.azure.com".
Dessutom m_sessionOverride kan ändras till ett befintligt sessions-ID. Sessioner kan skapas utanför det här exemplet. Mer information finns i RenderingSession.ps1 eller Använd REST API för sessionshantering direkt.

Att skapa en session utanför exemplet rekommenderas 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 startmenyn 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 huvudpositionen. Ocklusionmä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 HoloLens startmeny. Det kan ha ett sessions-ID som har upphört att gälla.

Nästa steg

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

Självstudie: Integrera fjärråtergivning i en HoloLens Holographic App

Dela via