De voorbeeld-app uitvoeren: 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, kunt u een gratis Azure-account maken 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. Voor HoloLens 2 moet de Update van Windows 10 mei 2020 of hoger op het apparaat zijn geïnstalleerd. Als u wilt bijwerken naar de nieuwste release op HoloLens, opent u de app Instellingen, gaat u naar Bijwerken en beveiliging en selecteert u vervolgens 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

Portal

Ga naar de Azure-portal.

Selecteer Een resource maken in het linkerdeelvenster.

Gebruik het zoekvak om te zoeken naar 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.

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

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.

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

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

Azure-CLI

Begin door de omgeving voor te bereiden op de Azure CLI:

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

1. Nadat u zich hebt aangemeld, gebruikt u de opdracht az account set om het abonnement te selecteren waarin u het account voor ruimtelijke ankers wilt instellen:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Voer de opdracht az group create uit om een resourcegroep te maken, of gebruik een bestaande resourcegroep:

   az group create --name myResourceGroup --location eastus2
   

   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.

   U kunt uw huidige accounts voor ruimtelijke ankers voor een resourcegroep weergeven met behulp van de opdracht az spatial-anchors-account list:

   az spatial-anchors-account list --resource-group myResourceGroup
   

   U kunt ook de accounts voor ruimtelijke ankers voor uw abonnement bekijken:

   az spatial-anchors-account list
   

3. Voer de opdracht az spatial-anchors-account create uit om een account voor ruimtelijke ankers te maken:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. Geef de resource-eigenschappen weer met behulp van de opdracht az spatial-anchors-account show:

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Kopieer de waarde voor Account-id van de resource en de waarde voor Accountdomein van de resource naar een teksteditor voor later gebruik.

5. Voer de opdracht az spatial-anchors-account key show uit om uw primaire en secundaire sleutels op te halen:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Kopieer de sleutelwaarden naar een teksteditor voor later gebruik.

   Als u sleutels opnieuw wilt genereren, gebruikt u de opdracht az spatial-anchors-account key renew:

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

U kunt een account verwijderen met de opdracht az spatial-anchors-account delete:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Begin door de omgeving voor te bereiden op Azure PowerShell:

• Als u ervoor kiest om Azure PowerShell lokaal te gebruiken:
  • Installeer de nieuwste versie van de Az PowerShell-module.
  • Maak verbinding met uw Azure-account met de cmdlet Connect-AzAccount.
• Als u ervoor kiest om Azure Cloud Shell te gebruiken:
  • Raadpleeg Overzicht van Azure Cloud Shell voor meer informatie.

Belangrijk

Zolang de PowerShell-module Az.MixedReality in de preview-fase is, moet u deze afzonderlijk installeren met behulp van de cmdlet Install-Module. Nadat de PowerShell-module algemeen beschikbaar is geworden, wordt deze onderdeel van toekomstige releases van de Az PowerShell-module en is deze standaard beschikbaar vanuit Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Nadat u zich hebt aangemeld, gebruikt u de cmdlet Set-AzContext om het abonnement te selecteren waarin u het ruimtelijke-ankersaccount wilt instellen:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Voer de cmdlet New-AzResourceGroup uit om een resourcegroep te maken, of gebruik een bestaande resourcegroep:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   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.

   U kunt uw huidige ruimtelijke-ankersaccounts voor een resourcegroep weergeven met behulp van de cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   U kunt ook de accounts voor ruimtelijke ankers voor uw abonnement bekijken:

   Get-AzSpatialAnchorsAccount
   

3. Voer de cmdlet New-AzSpatialAnchorsAccount uit om uw ruimtelijke-ankersaccount te maken:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Bekijk de resource-eigenschappen met behulp van de cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Kopieer de waarden voor de eigenschappen accountId en accountDomain in een teksteditor, voor later gebruik.

5. Voer de cmdlet Get-AzSpatialAnchorsAccountKey uit om uw primaire en secundaire sleutels uit te voeren:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Kopieer de sleutelwaarden naar een teksteditor voor later gebruik.

   Als u sleutels opnieuw wilt genereren, gebruikt u de cmdlet New-AzSpatialAnchorsAccountKey:

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

U kunt een account verwijderen met behulp van cmdlet Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

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.

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.

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.

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.

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.

Zelfstudie: Ruimtelijke ankers delen op verschillende apparaten

Procedure: Azure Spatial Anchors configureren in een Unity-project