Quickstart: Criar uma aplicação Xamarin Android com Âncoras Espaciais AzureQuickstart: Create a Xamarin Android app with Azure Spatial Anchors

Este quickstart cobre como criar uma aplicação Android com Xamarin usando Azure Spatial Anchors.This quickstart covers how to create an Android app with Xamarin using Azure Spatial Anchors. Azure Spatial Anchors é um serviço de desenvolvedor de plataformas cruzadas que permite criar experiências de realidade mista usando objetos que persistem a sua localização através dos dispositivos ao longo do tempo.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. Quando terminar, terá uma aplicação Android que pode economizar e recordar uma âncora espacial.When you're finished, you'll have an Android app that can save and recall a spatial anchor.

Vai aprender a:You'll learn how to:

  • Criar uma conta de Âncoras EspaciaisCreate a Spatial Anchors account
  • Configure o identificador de conta Spatial Anchors e a chave de contaConfigure the Spatial Anchors account identifier and account key
  • Implementar e executar num dispositivo AndroidDeploy and run on an Android device

Se não tiver uma subscrição do Azure,crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Pré-requisitosPrerequisites

Para concluir este início rápido, certifique-se de que tem:To complete this quickstart, make sure you have:

Criar um recurso de âncoras espaciaisCreate a Spatial Anchors resource

Aceda ao portal do Azure.Go to the Azure portal.

No painel esquerdo, selecione Criar um recurso.On the left pane, select Create a resource.

Utilize a caixa de pesquisa para procurar âncoras espaciais.Use the search box to search for Spatial Anchors.

Screenshot mostrando os resultados de uma pesquisa de Âncoras Espaciais.

Selecione Âncoras Espaciais e, em seguida, selecione Criar.Select Spatial Anchors, and then select Create.

No painel de contas de âncoras espaciais, faça o seguinte:On the Spatial Anchors Account pane, do the following:

  • Introduza um nome de recurso único utilizando caracteres alfanuméricos regulares.Enter a unique resource name by using regular alphanumeric characters.

  • Selecione a subscrição a que pretende anexar o recurso.Select the subscription that you want to attach the resource to.

  • Criar um grupo de recursos selecionando Criar novo.Create a resource group by selecting Create new. Nomeie-o myResourceGroup e, em seguida, selecione OK.Name it myResourceGroup, and then select OK.

    Um grupo de recursos é um recipiente lógico no qual os recursos da Azure, tais como aplicações web, bases de dados e contas de armazenamento, são implantados e geridos.A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.For example, you can choose to delete the entire resource group in one simple step later.

  • Selecione uma localização (região) na qual coloque o recurso.Select a location (region) in which to place the resource.

  • Selecione Novo para começar a criar o recurso.Select New to begin creating the resource.

Screenshot do painel de âncoras espaciais para criar um recurso.

Após a criação do recurso, o portal Azure mostra que a sua implantação está completa.After the resource is created, the Azure portal shows that your deployment is complete.

Screenshot mostrando que a implementação do recurso está completa.

Selecione Ir para recurso.Select Go to resource. Agora pode ver as propriedades dos recursos.You can now view the resource properties.

Copie o valor de ID da conta do recurso num editor de texto para utilização posterior.Copy the resource's Account ID value into a text editor for later use.

Screenshot do painel de propriedades de recursos.

Copie também o valor do Domínio da Conta do recurso num editor de texto para posterior utilização.Also copy the resource's Account Domain value into a text editor for later use.

Screenshot mostrando o valor do domínio da conta do recurso.

Em Definições, selecione Tecla.Under Settings, select Key. Copie o valor da chave principal, Chave de Conta, num editor de texto para posterior utilização.Copy the Primary key value, Account Key, into a text editor for later use.

Screenshot do painel keys para a conta.

Abra o projeto de amostraOpen the sample project

Clone o repositório de amostras executando os seguintes comandos: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

Aberto Xamarin/SampleXamarin.sln no Estúdio Visual.Open Xamarin/SampleXamarin.sln in Visual Studio.

Configure identificador de conta e chaveConfigure account identifier and key

O próximo passo é configurar a app para usar o identificador de conta e a chave da conta.The next step is to configure the app to use your account identifier and account key. Copiou-os para um editor de texto ao configurar o recurso Spatial Anchors.You copied them into a text editor when setting up the Spatial Anchors resource.

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

Localize o SpatialAnchorsAccountKey campo e Set me substitua-o pela chave de conta.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Localize o SpatialAnchorsAccountId campo e Set me substitua-o pelo identificador de conta.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Localize o SpatialAnchorsAccountDomain campo e Set me substitua-o pelo domínio da conta.Locate the SpatialAnchorsAccountDomain field and replace Set me with the account domain.

Implemente a aplicação para o seu dispositivo AndroidDeploy the app to your Android device

Ligue o dispositivo Android, inscreva-se e conecte-o ao computador utilizando um cabo USB.Power on the Android device, sign in, and connect it to the computer using a USB cable.

Defina o projeto de arranque para SampleXamarin.Android, altere a Configuração de Solução para Ser Lançada e selecione o dispositivo para o quais pretende implementar no seletor do dispositivo.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.

Screenshot que mostra o menu para selecionar o projeto e o dispositivo no Windows.

Selecione Debug > Comece a depurar para implementar e iniciar a sua aplicação.Select Debug > Start debugging to deploy and start your app.

Na aplicação, selecione Basic para executar a demonstração e siga as instruções para colocar e recordar uma âncora.In the app, select Basic to run the demo and follow the instructions to place and recall an anchor.

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

Limpar os recursosClean up resources

Nos passos anteriores, criou os recursos do Azure num grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

A partir do menu do portal Azure ou página Inicial, selecione Grupos de Recursos.From the Azure portal menu or Home page, select Resource groups. Em seguida, na página de grupos de recursos, selecione myResourceGroup.Then, on the Resource groups page, select myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são os que pretende eliminar.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Selecione Eliminar grupo de recursos, digite o myResourceGroup na caixa de texto para confirmar e, em seguida, selecione Delete.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Passos seguintesNext steps

Neste arranque rápido, criaste uma conta espacial.In this quickstart, you created a Spatial Anchors account. Em seguida, configuraste e implementaste uma aplicação para guardar e recordar âncoras espaciais.You then configured and deployed an app to save and recall spatial anchors. Para saber mais sobre como melhorar a app para que possa partilhar âncoras espaciais com outros dispositivos, continue para o próximo tutorial.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.