Quickstart: Systeemeigen C++ WMR-voorbeeld implementeren in HoloLens

Deze quickstart gaat over het implementeren en uitvoeren van de systeemeigen C++ WMR-zelfstudietoepassing (Windows Mixed Reality) op een HoloLens 2.

In deze snelstart leert u het volgende:

Vereisten

Als u toegang wilt krijgen tot de Azure Remote Rendering-service, moet u eerst een account maken.

De volgende software moet zijn geïnstalleerd:

• Windows SDK 10.0.18362.0 (download)
• De nieuwste versie van Visual Studio 2019 (download)
• Visual Studio Tools voor Mixed Reality. Met name de volgende workload-installaties zijn verplicht:
  • Desktopontwikkeling met C++
  • Universal Windows Platform (UWP)-ontwikkeling
• Git (downloaden)

De opslagplaats met de ARR-voorbeelden klonen

Als eerste stap klonen we de Git-opslagplaats, die de globale voorbeelden voor Azure Remote Rendering bevat. Open een opdrachtprompt (typ cmd in het menu Start van Windows) en ga naar een map waarin u het ARR-voorbeeldproject wilt opslaan.

Voer de volgende opdrachten uit:

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

Met de laatste opdracht maakt u een submap in de ARR-map die de verschillende voorbeeldprojecten voor Azure Remote Rendering bevat.

De zelfstudie C++ HoloLens vindt u in de subdirectory NativeCpp/HoloLens-Wmr.

Het project bouwen

Open het oplossingsbestand HolographicApp.sln in de subdirectory NativeCpp/HoloLens-Wmr met Visual Studio 2019.

Schakel de buildconfiguratie om naar Foutopsporing (of Release) en ARM64. Zorg er ook voor dat de foutopsporingsmodus is ingesteld op Apparaat en niet op Externe computer:

Omdat de accountreferenties worden vastgelegd in de broncode van de zelfstudie, wijzigt u deze in geldige referenties. Open het bestand in de Visual Studio en wijzig het onderdeel waarin de client wordt gemaakt HolographicAppMain.cpp in de constructor van klasse 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));
}

Wijzig met name de volgende waarden:

• init.AccountId, init.AccountKey en init.AccountDomain om uw accountgegevens te gebruiken. Zie de alinea over het ophalen van accountgegevens.
• Geef op waar de remote rendering-sessie moet worden gemaakt door het regiogedeelte van de tekenreeks te wijzigen voor andere regio's init.RemoteRenderingDomain dan , bijvoorbeeld westus2 "westeurope.mixedreality.azure.com" .
• Daarnaast kan m_sessionOverride worden gewijzigd in een bestaande sessie-id. Sessies kunnen buiten dit voorbeeld worden gemaakt, bijvoorbeeld door het PowerShell-script te gebruiken of door rechtstreeks de sessie-REST API te gebruiken. Het maken van een sessie buiten het voorbeeld wordt aanbevolen wanneer het voorbeeld meerdere keren moet worden uitgevoerd. Als er geen sessie wordt doorgegeven, maakt het voorbeeld een nieuwe sessie bij elke keer opstarten. Dit kan enkele minuten duren.

U kunt nu de toepassing compileren.

De toepassing starten

1. Sluit de HoloLens via een USB-kabel aan op uw pc.
2. Schakel de HoloLens in en wacht totdat het menu Start wordt weergegeven.
3. Start de foutopsporing in Visual Studio (F5). De app wordt automatisch geïmplementeerd op het apparaat.

De voorbeeld-app moet worden gestart en er moet een tekstvenster worden weergegeven waarin u wordt geïnformeerd over de huidige toepassingsstatus. De status bij het opstarten is ofwel een nieuwe sessie starten ofwel verbinding maken met een bestaande sessie. Nadat het laden van het model is voltooid, wordt het ingebouwde enginemodel op de hoofdpositie weergegeven. Het enginemodel blijkt goed te communiceren met de draaiende kubus die lokaal wordt weergegeven.

Als u het voorbeeld een tweede keer wilt starten, kunt u het ook vinden in het startmenu van HoloLens, maar houd er dan wel rekening mee dat er een verlopen sessie-id kan zijn gecompileerd.

Volgende stappen

Deze quickstart is gebaseerd op het resultaat van een zelfstudie waarin wordt uitgelegd hoe u alle onderdelen van Remote Rendering kunt integreren in een Holographic-app. Volg deze zelfstudie als u wilt weten welke stappen er nodig zijn: