Snabb start: skapa en HoloLens-app med Azures spatiala C++ankare, i/WinRT och DirectXQuickstart: Create a HoloLens app with Azure Spatial Anchors, in C++/WinRT and DirectX

I den här snabbstarten beskrivs hur du skapar en HoloLens-app med Azure Spatial Anchors i C++/WinRT och DirectX.This quickstart covers how to create a HoloLens app using Azure Spatial Anchors in C++/WinRT and DirectX. Azure Spatial Anchors är en plattformsoberoende utvecklartjänst som du kan använda för att skapa upplevelser med mixad verklighet med hjälp av objekt som bevarar sin plats mellan enheter över tid.Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. När du är klar har du en HoloLens-app som kan spara och återkalla en spatial fästpunkt.When you're finished, you'll have a HoloLens app that can save and recall a spatial anchor.

Du lär dig följande:You'll learn how to:

  • Skapa ett Spatial Anchors-kontoCreate a Spatial Anchors account
  • Konfigurera konto-ID och kontonyckel för Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Distribuera och köra på en HoloLens-enhetDeploy and run on a HoloLens device

Om du inte har en Azure-prenumeration kan du skapa ettkostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

KravPrerequisites

Kontrollera att du har följande så att du kan utföra den här snabbstarten:To complete this quickstart, make sure you have:

Skapa en Spatial Anchors-resursCreate a Spatial Anchors resource

Gå till Azure-portalen.Go to the Azure portal.

I det vänstra navigeringsfönstret i Azure-portalen, väljer skapa en resurs.In the left navigation pane in the Azure portal, select Create a resource.

Använd sökrutan för att söka efter Spatial ankare.Use the search box to search for Spatial Anchors.

Söka efter Spatial Anchors

Välj Spatial ankare.Select Spatial Anchors. I dialogrutan Välj skapa.In the dialog box, select Create.

I den Spatial ankare konto dialogrutan:In the Spatial Anchors Account dialog box:

  • Ange ett unikt resursnamn, med hjälp av vanliga alfanumeriska tecken.Enter a unique resource name, using regular alphanumeric characters.

  • Välj den prenumeration som du vill koppla till resursen.Select the subscription that you want to attach the resource to.

  • Skapa en resursgrupp genom att välja Skapa ny.Create a resource group by selecting Create new. Ge den namnet myResourceGroup och välj OK.Name it myResourceGroup and select OK. En resursgrupp är en logisk container som Azure-resurser (t.ex. webbappar, databaser och lagringskonton) distribueras och hanteras i.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.For example, you can choose to delete the entire resource group in one simple step later.

  • Välj en plats (region) där du vill placera resursen.Select a location (region) in which to place the resource.

  • Välj Ny för att börja skapa resursen.Select New to begin creating the resource.

    Skapa en resurs

När resursen har skapats visar Azure-portalen att distributionen har slutförts.After the resource is created, Azure Portal will show that your deployment is complete. Klicka på Gå till resurs.Click Go to resource.

Distributionen är klar

Du kan sedan visa egenskaper för resursen.Then, you can view the resource properties. Kopiera resursens konto-ID värde i en textredigerare, eftersom du behöver senare.Copy the resource's Account ID value into a text editor because you'll need it later.

Resursegenskaper

Under inställningarväljer nyckeln.Under Settings, select Key. Kopiera den primärnyckel värde i en textredigerare.Copy the Primary key value into a text editor. Det här värdet är den Account Key.This value is the Account Key. Du behöver det senare.You'll need it later.

Kontonyckel

Öppna exempelprojektetOpen the sample project

Klona exempellagringsplatsen genom att köra följande kommando:Clone the samples repository by running the following command:

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

Öppna HoloLens\DirectX\SampleHoloLens.sln i Visual Studio.Open HoloLens\DirectX\SampleHoloLens.sln in Visual Studio.

Konfigurera konto-ID och -nyckelConfigure account identifier and key

Nästa steg är att konfigurera appen så att den använder din konto identifierare och konto nyckeln.The next step is to configure the app to use your account identifier and account key. Du kopierade dem till en text redigerare när du ställer in resursen för spatiala ankare.You copied them into a text editor when setting up the Spatial Anchors resource.

Öppna HoloLens\DirectX\SampleHoloLens\ViewController.cpp.Open HoloLens\DirectX\SampleHoloLens\ViewController.cpp.

Leta upp fältet SpatialAnchorsAccountKey och ersätt Set me med kontonyckeln.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Leta upp fältet SpatialAnchorsAccountId och ersätt Set me med kontoidentifieraren.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Distribuera appen till din HoloLensDeploy the app to your HoloLens

Ändra Lösningskonfiguration till Version, ändra Lösningsplattform till x86 och välj Enhet bland alternativen för distributionsmål.Change the Solution Configuration to Release, change Solution Platform to x86, and select Device from the deployment target options.

Om du använder HoloLens 2 använder du arm64 som lösnings plattformi stället för x86.If using HoloLens 2, use ARM64 as the Solution Platform, instead of x86.

Visual Studio-konfiguration

Slå på HoloLens-enheten, logga in och anslut den till datorn via en USB-kabel.Power on the HoloLens device, sign in, and connect it to the PC using a USB cable.

Välj Felsök > Starta felsökning för att distribuera appen och börja felsöka.Select Debug > Start debugging to deploy your app and start debugging.

Följ instruktionerna i appen för att placera och återkalla en fästpunkt.Follow the instructions in the app to place and recall an anchor.

Stoppa appen i Visual Studio genom att välja Stoppa felsökning eller trycka på Skift+F5.In Visual Studio, stop the app by either selecting Stop Debugging or pressing Shift + F5.

Rensa resurserClean up resources

I de föregående stegen skapade du Azure-resurser i en resursgrupp.In the preceding steps, you created Azure resources in a resource group. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Från Azure Portal-menyn eller Start sidan väljer du resurs grupperoch på sidan resurs grupper väljer du myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

På sidan myResourceGroup kontrollerar du att de listade resurserna är de som du vill ta bort.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Välj Ta bort, skriv myResourceGroup i textrutan och välj sedan Ta bort.Select Delete, type myResourceGroup in the text box, and then select Delete.

Nästa stegNext steps

I den här snabbstarten har skapade du ett konto för Spatial fästpunkter.In this quickstart, you created a Spatial Anchors account. Du kan sedan konfigureras och distribueras en app för att spara och hämta spatial fästpunkter.You then configured and deployed an app to save and recall spatial anchors. Fortsätt till nästa självstudie om du vill veta mer om hur du förbättrar appen så att den kan dela spatial ankare med andra enheter.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.