Voer de voorbeeld-app uit: HoloLens - Unity (C#)

In deze quickstart voert u de Azure Spatial Anchors-voorbeeld-app uit voor HoloLens met behulp van Unity (C#). Spatial Anchors is een platformoverschrijdende ontwikkelaarsservice waarmee u mixed reality-ervaringen kunt maken met objecten die hun locatie in de loop van de tijd op meerdere apparaten behouden. Als u klaar bent, hebt u een HoloLens-app met Unity gemaakt waarmee een ruimtelijk anker kan worden opgeslagen en teruggehaald.

U leert het volgende:

  • Een Spatial Anchors-account maken.
  • Build-instellingen voor Unity voorbereiden.
  • De Spatial Anchors-account-id en -accountsleutel configureren.
  • Het HoloLens Visual Studio-project exporteren.
  • De app implementeren en uitvoeren op een HoloLens-apparaat.

Als u geen Azure-abonnement hebt, maakt u een gratis Azure-account voordat u begint.

Vereisten

Dit zijn de vereisten voor het voltooien van deze snelstart:

  • U hebt een HoloLens apparaat nodig waarvoor de ontwikkelaarsmodus is ingeschakeld. Windows 10 update van mei 2020 of hoger moet op het apparaat zijn geïnstalleerd. Als u wilt bijwerken naar de nieuwste versie op HoloLens, opent u de Instellingen-app, gaat u naar Updatebeveiliging &en selecteert u Controleren op updates.
  • U hebt een Windows computer nodig waarop Visual Studio 2019 of hoger is geïnstalleerd. Uw installatie van Visual Studio moet de workload Universeel Windows-platform ontwikkeling en het onderdeel Windows 10 SDK (10.0.18362.0 of later) omvatten. U moet ook Git voor Windows en Git LFS installeren.
  • U moet Unity hebben geïnstalleerd. Ga naar de installatiepagina van het Unity-project voor ondersteunde versies en vereiste mogelijkheden.

Een Spatial Anchors-resource maken

Ga naar de Azure Portal.

Selecteer Een resource maken in het linkerdeelvenster.

Gebruik het zoekvak om te zoeken naar Spatial Anchors.

Screenshot showing the results of a search for Spatial Anchors.

Selecteer Spatial Anchors en vervolgens Maken.

Doe in het deelvenster Spatial Anchors-account het volgende:

  • Voer een unieke resourcenaam in met gewone alfanumerieke tekens.

  • Selecteer het abonnement waaraan u de resource wilt koppelen.

  • Maak een resourcegroep door Nieuwe maken te selecteren. Noem deze myResourceGroup en selecteer OK.

    Een resourcegroep is een logische container waarin Azure-resources, zoals web-apps, databases en opslagaccounts, worden geïmplementeerd en beheerd. U kunt bijvoorbeeld later de hele resourcegroep in één stap verwijderen.

  • Selecteer de locatie (regio) waarin u de resource wilt plaatsen.

  • Selecteer Maken om de resource te maken.

Screenshot of the Spatial Anchors pane for creating a resource.

Nadat de resource is gemaakt, ziet u in de Azure-portal dat uw implementatie is voltooid.

Screenshot showing that the resource deployment is complete.

Selecteer Naar resource. Nu kunt u de resource-eigenschappen bekijken.

Kopieer de waarde bij Account-id van de resource naar een teksteditor om later te gebruiken.

Screenshot of the resource properties pane.

Kopieer ook de waarde bij Accountdomein van de resource naar een teksteditor om later te gebruiken.

Screenshot showing the resource's account domain value.

Selecteer toegangssleutel onder Instellingen. Kopieer de waarde bij Primaire sleutel, Accountsleutel, naar een teksteditor om later te gebruiken.

Screenshot of the Keys pane for the account.

Voorbeeldproject downloaden en SDK importeren

Opslagplaats voor kloonvoorbeelden

Voer de volgende opdrachten uit om de opslagplaats met voorbeelden te klonen:

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

ASA SDK importeren

Volg de instructies hier om de ASA SDK-pakketten te downloaden en te importeren die vereist zijn voor het HoloLens-platform.

Unity configureren

Open het project in Unity in de map Unity. Unity geeft mogelijk een melding weer over een verschil tussen de versie in het project en de versie die op uw computer is geïnstalleerd. Dit is in orde, zolang uw versie van Unity Editor nieuwer is dan de versie waarmee het project is gemaakt. Als uw versie nieuwer is, selecteert u Doorgaan. Als uw versie ouder is dan voor het project nodig is, selecteert u Afsluiten en werkt u Unity Editor bij.

Screenshot of the Unity pane.

Open Build Settings door File>Build Settings te selecteren.

in de sectie Platform selecteert u Universeel Windows-platform. Wijzig Doelapparaat in HoloLens.

Selecteer Switch Platform om het platform te wijzigen in Universeel Windows-platform. U kunt worden gevraagd UWP-ondersteuningsonderdelen te installeren als deze ontbreken.

Screenshot of the Unity Build Settings pane - HoloLens

Sluit het venster Build Settings.

De accountgegevens configureren

De volgende stap is om de app te configureren voor gebruik van uw accountgegevens. U hebt eerder de waarden accountsleutel, account-IDen accountdomein gekopieerd naar een teksteditor in de sectie "Een Spatial Anchors-resource maken".

Ga in het deelvenster Project naar Assets\AzureSpatialAnchors.SDK\Resources.

Selecteer SpatialAnchorConfig. Voer in het deelvenster Controle de Account Key in als de waarde voor Spatial Anchors-accountsleutel, de Account ID als de waarde voor Spatial Anchors-id en de Account Domain als de waarde voor Spatial Anchors-accountdomein.

Het HoloLens Visual Studio-project exporteren

Open Build Settings door File>Build Settings te selecteren.

Controleer onder Scènes in Build of er naast elke scène een selectievakje staat.

Selecteer Build. Selecteer in het dialoogvenster een map waarnaar het HoloLens Visual Studio-project kan worden geëxporteerd.

Als het exporteren is voltooid, wordt er een map weergegeven met het geëxporteerde HoloLens-project.

HoloLens-toepassing implementeren

Dubbelklik in de map op HelloAR U3D.sln om het project in Visual Studio te openen.

Wijzig Solution Configuration in Release, wijzig het Solution Platform in x86 en selecteer Device uit de opties voor het implementatiedoel.

Als u HoloLens 2 gebruikt, gebruikt u ARM64 als het Solution Platform, in plaats van x86.

Visual Studio configuration

Schakel het HoloLens-apparaat in, meld u aan en sluit het apparaat aan op de pc via een USB-kabel.

Selecteer Debug>Start debugging om de app te implementeren en de foutopsporing te starten.

Selecteer BasicDemo in de app met behulp van de pijlen en druk vervolgens op de knop Go! om de demo uit te voeren. Volg de instructies om een anker te plaatsen en terug te halen.

Screenshot 1Screenshot 2Screenshot 3Screenshot 4

Stop de app in Visual Studio door Stop Debugging of Shift+F5 te selecteren.

Resources opschonen

In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.

Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.

Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.

Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.

Volgende stappen

In deze quickstart hebt u een account voor Spatial Anchors gemaakt. Vervolgens hebt u een app geconfigureerd en geïmplementeerd om ruimtelijk ankers op te slaan en terug te halen. Ga door naar de volgende zelfstudie voor meer informatie over het verbeteren van de app, zodat het ruimtelijk ankers kan delen met andere apparaten.