Início rápido: Criar um aplicativo Android com âncoras espaciais do AzureQuickstart: Create an Android app with Azure Spatial Anchors

Este guia de início rápido aborda como criar um aplicativo Android usando âncoras espaciais do Azure em Java ou C++/NDK.This quickstart covers how to create an Android app using Azure Spatial Anchors in either Java or C++/NDK. As âncoras espaciais do Azure são um serviço de desenvolvedor de plataforma cruzada que permite que você crie experiências de realidade mista usando objetos que persistem seu local entre 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 tiver terminado, você terá um aplicativo ARCore Android que pode salvar e recuperar uma âncora espacial.When you're finished, you'll have an ARCore 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
  • Configurar o identificador de conta de âncoras espaciais e a chave de contaConfigure the Spatial Anchors account identifier and account key
  • Implantar e executar em um dispositivo AndroidDeploy and run on an Android device

Se não tiver uma subscrição do Azure, criar um 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:

  • Um computador com Windows ou macOS com o Android Studio 3.4 +.A Windows or macOS machine with Android Studio 3.4+.
    • Se estiver executando no Windows, você também precisará do git para Windows.If running on Windows, you'll also need Git for Windows.
    • Se estiver em execução no macOS, obtenha o Git instalado via HomeBrew.If running on macOS, get Git installed via HomeBrew. Digite o seguinte comando em uma única linha do terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".Enter the following command into a single line of the Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Em seguida, brew install gitexecute.Then, run brew install git.
    • Para criar o exemplo de NDK, você também precisará instalar o NDK e CMake 3,6 ou superior SDK Tools em Android Studio.To build the NDK sample, you'll also need to install the NDK and CMake 3.6 or greater SDK Tools in Android Studio.
  • Um dispositivo Android habilitado por desenvolvedor e com ARCore .A developer enabled and ARCore capable Android device.
    • Drivers de dispositivo adicionais podem ser necessários para que seu computador se comunique com seu dispositivo Android.Additional device drivers may be required for your computer to communicate with your Android device. Consulte aqui para obter informações e instruções adicionais.See here for additional information and instructions.
  • Seu aplicativo deve ter como destino o ARCore 1,8.Your app must target ARCore 1.8.

Criar um recurso de âncoras espaciaisCreate a Spatial Anchors resource

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

No painel de navegação esquerdo no portal do Azure, selecione criar um recurso.In the left navigation pane in the Azure portal, select Create a resource.

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

Procure as âncoras espaciais

Selecione geográficos âncoras.Select Spatial Anchors. Na caixa de diálogo, selecione criar.In the dialog box, select Create.

Na geográficos de âncoras de conta caixa de diálogo:In the Spatial Anchors Account dialog box:

  • Introduza um nome de recurso exclusiva, usando caracteres de alfanuméricos regulares.Enter a unique resource name, using regular alphanumeric characters.

  • Selecione a subscrição 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. Atribua o nome myResourceGroup e selecione OK.Name it myResourceGroup and select OK. Um grupo de recursos é um contentor lógico em que os recursos do Azure, como aplicações Web, bases de dados e contas de armazenamento são implementados e geridos.A resource group is a logical container into which Azure resources like 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) onde colocar o recurso.Select a location (region) in which to place the resource.

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

    Criar um recurso

Depois do recurso é criado, o Portal do Azure irá mostrar que a implementação está completa.After the resource is created, Azure Portal will show that your deployment is complete. Clique em Ir para recurso.Click Go to resource.

Conclusão da implantação

Em seguida, pode ver as propriedades de recurso.Then, you can view the resource properties. Copiar do recurso ID da conta valor num editor de texto, porque irá precisar dele mais tarde.Copy the resource's Account ID value into a text editor because you'll need it later.

Propriedades de recurso

Sob configurações, selecione chave.Under Settings, select Key. Copiar o chave primária valor num editor de texto.Copy the Primary key value into a text editor. Este valor é o Account Key.This value is the Account Key. Precisará dela mais tarde.You'll need it later.

Chave de conta

Abrir o projeto de exemploOpen the sample project

Clone o repositório de exemplos executando o seguinte comando:Clone the samples repository by running the following command:

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

Abra o Android Studio.Open Android Studio.

Selecione abrir um projeto de Android Studio existente e selecione o projeto localizado Android/Java/em.Select Open an existing Android Studio project and select the project located at Android/Java/.

Configurar o identificador e a chave da contaConfigure account identifier and key

A próxima etapa é configurar o aplicativo para usar o identificador de conta e a chave de conta.The next step is to configure the app to use your account identifier and account key. Você os copiou em um editor de texto ao Configurar o recurso âncoras espaciais.You copied them into a text editor when setting up the Spatial Anchors resource.

Abra Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.javao.Open Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

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

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

Implantar o aplicativo em seu dispositivo AndroidDeploy the app to your Android device

Ligue o dispositivo Android, entre e conecte-o ao PC usando um cabo USB.Power on the Android device, sign in, and connect it to the PC using a USB cable.

Selecione executar na barra de ferramentas Android Studio.Select Run from the Android Studio toolbar.

Android Studio implantar e executar

Selecione o dispositivo Android na caixa de diálogo Selecionar destino de implantação e selecione OK para executar o aplicativo no dispositivo Android.Select the Android device in the Select Deployment Target dialog, and select OK to run the app on the Android device.

Siga as instruções no aplicativo para colocá-lo e relembrar uma âncora.Follow the instructions in the app to place and recall an anchor.

Pare o aplicativo selecionando parar na barra de ferramentas Android Studio.Stop the app by selecting Stop from the Android Studio toolbar.

Android Studio parar

Limpar 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.

No menu esquerdo do portal do Azure, clique em Grupos de recursos e, em seguida, clique em myResourceGroup.From the left menu in the Azure portal, select Resource groups and then select myResourceGroup.

Na página do grupo de recursos, confirme que os recursos apresentados são aqueles que pretende eliminar.On the resource group page, make sure that the listed resources are the ones you want to delete.

Selecione Eliminar, introduza myResourceGroup na caixa de texto e, em seguida, selecione Eliminar.Select Delete, type myResourceGroup in the text box, and then select Delete.

Passos SeguintesNext steps

Neste início rápido, tiver criado uma conta de âncoras espaciais.In this quickstart, you created a Spatial Anchors account. Em seguida, configurou e implementou uma aplicação para guardar e lembre-se de âncoras espaciais.You then configured and deployed an app to save and recall spatial anchors. Para saber mais sobre como melhorar a aplicação para que possa partilhar as âncoras espaciais com outros dispositivos, avance 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.