Quickstart: Een Xamarin Android-app maken met Azure Spatial AnchorsQuickstart: Create a Xamarin Android app with Azure Spatial Anchors

In deze quickstart wordt besproken hoe u een Android-app met Xamarin maakt met behulp van Azure Spatial Anchors.This quickstart covers how to create an Android app with Xamarin using Azure Spatial Anchors. Azure Spatial Anchors is een platformoverstijgende ontwikkelaarsservice waarmee u mixed reality-ervaringen kunt maken met behulp van objecten die hun locatie in de loop van de tijd op meerdere apparaten behouden.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. Als u klaar bent, hebt u een Android-app gemaakt waarmee een ruimtelijk anker kan worden opgeslagen en teruggehaald.When you're finished, you'll have an Android app that can save and recall a spatial anchor.

U leert het volgende:You'll learn how to:

  • Een Spatial Anchors-account makenCreate a Spatial Anchors account
  • Spatial Anchors-account-id en -accountsleutel configurerenConfigure the Spatial Anchors account identifier and account key
  • Implementeren en uitvoeren op een Android-apparaatDeploy and run on an Android device

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

VereistenPrerequisites

Zorg ervoor dat u over het volgende beschikt om deze snelstart te voltooien:To complete this quickstart, make sure you have:

Een Spatial Anchors-resource makenCreate a Spatial Anchors resource

Ga naar de Azure Portal.Go to the Azure portal.

Selecteer Een resource maken in het linkerdeelvenster.On the left pane, select Create a resource.

Gebruik het zoekvak om te zoeken naar Spatial Anchors.Use the search box to search for Spatial Anchors.

Schermopname met de resultaten van een zoekopdracht naar Spatial Anchors.

Selecteer Spatial Anchors en vervolgens Maken.Select Spatial Anchors, and then select Create.

Doe in het deelvenster Spatial Anchors-account het volgende:On the Spatial Anchors Account pane, do the following:

  • Voer een unieke resourcenaam in met gewone alfanumerieke tekens.Enter a unique resource name by using regular alphanumeric characters.

  • Selecteer het abonnement waaraan u de resource wilt koppelen.Select the subscription that you want to attach the resource to.

  • Maak een resourcegroep door Nieuwe maken te selecteren.Create a resource group by selecting Create new. Noem deze myResourceGroup en selecteer OK.Name it myResourceGroup, and then select OK.

    Een resourcegroep is een logische container waarin Azure-resources, zoals web-apps, databases en opslagaccounts, worden geïmplementeerd en beheerd.A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. U kunt bijvoorbeeld later de hele resourcegroep in één stap verwijderen.For example, you can choose to delete the entire resource group in one simple step later.

  • Selecteer de locatie (regio) waarin u de resource wilt plaatsen.Select a location (region) in which to place the resource.

  • Selecteer Nieuw om te beginnen met het maken van de resource.Select New to begin creating the resource.

Schermopname van het deelvenster Spatial Anchors voor het maken van een resource.

Nadat de resource is gemaakt, ziet u in de Azure-portal dat uw implementatie is voltooid.After the resource is created, the Azure portal shows that your deployment is complete.

Schermopname die laat zien dat de resource-implementatie is voltooid.

Selecteer Naar resource.Select Go to resource. Nu kunt u de resource-eigenschappen bekijken.You can now view the resource properties.

Kopieer de waarde bij Account-id van de resource naar een teksteditor om later te gebruiken.Copy the resource's Account ID value into a text editor for later use.

Schermopname van het deelvenster met resource-eigenschappen.

Kopieer ook de waarde bij Accountdomein van de resource naar een teksteditor om later te gebruiken.Also copy the resource's Account Domain value into a text editor for later use.

Schermopname van de accountdomeinwaarde van de resource.

Selecteer onder Instellingen de optie Sleutel.Under Settings, select Key. Kopieer de waarde bij Primaire sleutel, Accountsleutel, naar een teksteditor om later te gebruiken.Copy the Primary key value, Account Key, into a text editor for later use.

Schermopname van het deelvenster Sleutels voor het account.

Voorbeeldproject openenOpen the sample project

Voer de volgende opdrachten uit om de opslagplaats met voorbeelden te klonen:Clone the samples repository by running the following commands:

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

Open Xamarin/SampleXamarin.sln in Visual Studio.Open Xamarin/SampleXamarin.sln in Visual Studio.

Account-id en -sleutel configurerenConfigure account identifier and key

De volgende stap is om de app te configureren om uw account-id en accountsleutel te gebruiken.The next step is to configure the app to use your account identifier and account key. U hebt ze naar een teksteditor gekopieerd bij het instellen van de Spatial Anchors-resource.You copied them into a text editor when setting up the Spatial Anchors resource.

Open Xamarin/SampleXamarin.Common/AccountDetails.cs.Open Xamarin/SampleXamarin.Common/AccountDetails.cs.

Zoek het veld SpatialAnchorsAccountKey en vervang Set me met de accountsleutel.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Zoek het veld SpatialAnchorsAccountId en vervang Set me met de account-id.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Zoek het veld SpatialAnchorsAccountDomain en vervang Set me door het accountdomein.Locate the SpatialAnchorsAccountDomain field and replace Set me with the account domain.

De app op uw Android-apparaat implementerenDeploy the app to your Android device

Start het Android-apparaat, meld u aan en maak verbinding met de computer via een USB-kabel.Power on the Android device, sign in, and connect it to the computer using a USB cable.

Stel het opstartproject in op SampleXamarin.Android, wijzig de oplossingconfiguratie naar Release en selecteer het apparaat waarop u wilt implementeren in de vervolgkeuzelijst Apparaat selecteren.Set the startup project to SampleXamarin.Android, change the Solution Configuration to Release, and select the device you want to deploy to in the device selector drop-down.

Schermopname van het menu om het project en apparaat in Windows te selecteren.

Selecteer Fouten opsporen > Fouten opsporen starten om uw app te implementeren en te starten.Select Debug > Start debugging to deploy and start your app.

Selecteer in de app Basisinstellingen om de demo uit te voeren en volg de instructies om een bladwijzer te plaatsen en opnieuw aan te roepen.In the app, select Basic to run the demo and follow the instructions to place and recall an anchor.

Schermafbeelding 1 Schermafbeelding 2 Schermafbeelding 3Screenshot 1 Screenshot 2 Screenshot 3

Resources opschonenClean up resources

In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt.In the preceding steps, you created Azure resources in a resource group. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal.From the Azure portal menu or Home page, select Resource groups. Selecteer myResourceGroup op de pagina Resourcegroepen.Then, on the Resource groups page, select myResourceGroup.

Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Volgende stappenNext steps

In deze quickstart hebt u een account voor Spatial Anchors gemaakt.In this quickstart, you created a Spatial Anchors account. Vervolgens hebt u een app geconfigureerd en geïmplementeerd om ruimtelijk ankers op te slaan en terug te halen.You then configured and deployed an app to save and recall spatial anchors. Ga door naar de volgende zelfstudie voor meer informatie over het verbeteren van de app, zodat het ruimtelijk ankers kan delen met andere apparaten.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.