Quickstart: Een Xamarin iOS-app maken met Azure Spatial Anchors

In deze quickstart wordt besproken hoe u een iOS-app met Xamarin maakt met behulp van 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. Als u klaar bent, hebt u een iOS-app gemaakt waarmee een ruimtelijk anker kan worden opgeslagen en teruggehaald.

U leert het volgende:

  • Een Spatial Anchors-account maken
  • De Spatial Anchors-account-id en -accountsleutel configureren
  • Implementeren en uitvoeren op een iOS-apparaat

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

Vereisten

Zorg ervoor dat u over het volgende beschikt om deze snelstart te voltooien:

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.

Schermopname met de resultaten van een zoekopdracht 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 te beginnen met het maken van de 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.

Schermopname die laat zien dat de resource-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.

Schermopname van het deelvenster met resource-eigenschappen.

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

Schermopname van de accountdomeinwaarde van de resource.

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

Schermopname van het deelvenster Sleutels voor het account.

Voorbeeldproject openen

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

Open Xamarin/SampleXamarin.sln in Visual Studio.

Account-id en -sleutel configureren

De volgende stap is om de app te configureren om uw account-id en accountsleutel te gebruiken. U hebt ze naar een teksteditor gekopieerd bij het instellen van de Spatial Anchors-resource.

Open Xamarin/SampleXamarin.Common/AccountDetails.cs.

Zoek het veld SpatialAnchorsAccountKey en vervang Set me met de accountsleutel.

Zoek het veld SpatialAnchorsAccountId en vervang Set me met de account-id.

Zoek het veld SpatialAnchorsAccountDomain en vervang Set me door het accountdomein.

De app implementeren op uw iOS-apparaat

Start het iOS-apparaat, meld u aan en maak verbinding met de computer via een USB-kabel.

Stel het opstartproject in op SampleXamarin.iOS, wijzig de oplossingsconfiguratie in Release en selecteer het apparaat waarop u wilt implementeren in de vervolgkeuzelijst Apparaat selecteren.

Configuratie van Visual Studio

Selecteer Uitvoeren > Starten zonder fout opsporing om uw app te implementeren en te starten.

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.

Schermafbeelding 1 Schermafbeelding 2 Schermafbeelding 3

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.