Kör exempelappen: HoloLens – Unity (C#)

I den här snabbstarten kör du Azure Spatial Anchors-exempelappen för HoloLens med unity (C#). Spatial Anchors är en plattformsoberoende utvecklartjänst som gör att du kan skapa upplevelser med mixad verklighet med objekt som bevarar sin plats över flera enheter över tid. När du är klar har du en HoloLens-app som skapats med Unity och som kan spara och återkalla en spatial fästpunkt.

Du lär dig följande:

  • Skapa ett Spatial Anchors-konto.
  • Förbereda Unity-bygginställningar.
  • Konfigurera Spatial Anchors-kontoidentifieraren och kontonyckeln.
  • Exportera HoloLens Visual Studio projektet.
  • Distribuera appen och kör den på en HoloLens enhet.

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto innan du börjar.

Förutsättningar

För att slutföra den här snabbstarten behöver du:

  • Du behöver en HoloLens enhet med utvecklarläge aktiverat. Windows 10 uppdatering maj 2020 eller senare måste installeras på enheten. Om du vill uppdatera till den senaste versionen på HoloLens öppnar du appen Inställningar, går till Uppdateringssäkerhet &och väljer sedan Sök efter uppdateringar.
  • Du behöver en Windows dator med Visual Studio 2019 eller senare installerad. Din Visual Studio måste innehålla arbetsbelastningen Universell Windows-plattform utveckling och komponenten Windows 10 SDK (10.0.18362.0 eller senare). Du måste också installera Git för Windows och Git LFS.
  • Du måste ha Unity installerat. Om du vill ha versioner som stöds och nödvändiga funktioner går du till installationssidan för Unity-projekt.

Skapa en Spatial Anchors-resurs

Gå till Azure-portalen.

Välj Skapa en resurs i den vänstra rutan.

Använd sökrutan för att söka efter Spatial Anchors.

Screenshot showing the results of a search for Spatial Anchors.

Välj Spatial Anchors och sedan Skapa.

Gör följande i fönstret Spatial Anchors-konto :

  • Ange ett unikt resursnamn med hjälp av vanliga alfanumeriska tecken.

  • Välj den prenumeration som du vill koppla resursen till.

  • Skapa en resursgrupp genom att välja Skapa ny. Ge den namnet myResourceGroup och välj sedan OK.

    En resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.

  • Välj en plats (region) där du vill placera resursen.

  • Välj Skapa för att börja skapa resursen.

Screenshot of the Spatial Anchors pane for creating a resource.

När resursen har skapats visar Azure Portal att distributionen är klar.

Screenshot showing that the resource deployment is complete.

Välj Gå till resurs. Nu kan du visa resursegenskaperna.

Kopiera resursens konto-ID-värde till en textredigerare för senare användning.

Screenshot of the resource properties pane.

Kopiera även resursens kontodomänvärde till en textredigerare för senare användning.

Screenshot showing the resource's account domain value.

Under Inställningar väljer du Åtkomstnyckel. Kopiera värdet för Primärnyckel , Kontonyckel, till en textredigerare för senare användning.

Screenshot of the Keys pane for the account.

Ladda ned exempelprojekt och importera SDK

Lagringsplats för klonexempel

Klona exempellagringsplatsen genom att köra följande kommandon:

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

Importera ASA SDK

Följ anvisningarna här för att ladda ned och importera de ASA SDK-paket som krävs för HoloLens-plattformen.

Konfigurera Unity

Öppna projektet i Unity-mappen i Unity. Unity kan fråga dig om en skillnad mellan versionen i projektet och den version som är installerad på datorn. Den här varningen är okej, så länge din version av Unity Editor är nyare än den som projektet skapades med. Om din version är nyare väljer du Fortsätt. Om din version är äldre än den som projektet behöver väljer du Avsluta och uppgraderar Unity-redigeraren.

Screenshot of the Unity pane.

Öppna Build Settings (Bygginställningar) genom att välja Arkiv>Build Settings (Bygginställningar).

I avsnittet Plattform väljer du Universell Windows-plattform. Ändra Målenhet till HoloLens.

Välj Switch Platform (Växla plattform) för att ändra plattformen till Universell Windows-plattform. Unity kan uppmana dig att installera UWP-stödkomponenter om de saknas.

Screenshot of the Unity Build Settings pane - HoloLens

Stäng fönstret Build Settings (Bygginställningar).

Konfigurera kontoinformationen

Nästa steg är att konfigurera appen så att den använder din kontoinformation. Du kopierade värdena kontonyckel, konto-ID och kontodomän till en textredigerare tidigare i avsnittet "Skapa en Spatial Anchors-resurs" .

I fönstret Project går du till Assets\AzureSpatialAnchors.SDK\Resources.

Välj SpatialAnchorConfig. I fönstret Kontroll anger du Account Key som värde för Spatial Anchors-kontonyckeln, Account ID som värde för Spatial Anchors-konto-ID och Account Domain som värde för Spatial Anchors-kontodomänen.

Exportera HoloLens Visual Studio-projektet

Öppna Build Settings (Bygginställningar) genom att välja Arkiv>Build Settings (Bygginställningar).

Under Scener i build kontrollerar du att alla scener har en bock bredvid sig.

Välj Skapa. I dialogrutan väljer du en mapp där du vill exportera HoloLens Visual Studio projektet.

När exporten är klar visas en mapp som innehåller det exporterade HoloLens projektet.

Distribuera HoloLens-programmet

Dubbelklicka på HelloAR U3D.sln i mappen för att öppna projektet i Visual Studio.

Ändra Lösningskonfiguration till Släpp, ändra Lösningsplattform till x86 och välj Enhet från distributionsmålalternativen.

Om du använder HoloLens 2 använder du ARM64 som Lösningsplattform i stället för x86.

Visual Studio configuration

Aktivera HoloLens enheten, logga in och anslut enheten till datorn med hjälp av en USB-kabel.

Välj FelsökStarta>felsökning för att distribuera din app och börja felsöka.

I appen väljer du BasicDemo med hjälp av pilarna och trycker sedan på knappen Go! för att köra demonstrationen. Följ anvisningarna för att placera och återkalla en fästpunkt.

Screenshot 1Screenshot 2Screenshot 3Screenshot 4

I Visual Studio stoppar du appen genom att välja Stoppa felsökning eller Skift+F5.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

På Azure Portal-menyn eller startsidan väljer du Resursgrupper. På sidan Resursgrupper väljer du sedan myResourceGroup.

På sidan myResourceGroup kontrollerar du att resurserna i listan är de som du vill ta bort.

Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan för att bekräfta och välj sedan Ta bort.

Nästa steg

I den här snabbstarten skapade du ett Spatial Anchors-konto. Sedan konfigurerade och distribuerade du en app för att spara och återkalla spatiala fästpunkter. Om du vill veta mer om hur du förbättrar appen så att den kan dela spatiala fästpunkter med andra enheter fortsätter du till nästa självstudie.