Início Rápido: Criar um aplicativo para Android com as Âncoras Espaciais do AzureQuickstart: Create an Android app with Azure Spatial Anchors

Este 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 multiplataforma para você criar experiências de realidade misturada usando objetos que persistem sua localização em todos os 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 do ARCore para Android que pode salvar e lembrar de uma âncora espacial.When you're finished, you'll have an ARCore Android app that can save and recall a spatial anchor.

Você aprenderá a:You'll learn how to:

  • Criar uma conta de Âncoras EspaciaisCreate a Spatial Anchors account
  • Configurar o identificador e a chave de conta das Âncoras EspaciaisConfigure the Spatial Anchors account identifier and account key
  • Implantar e executar um dispositivo AndroidDeploy and run on an Android device

Se você não tiver uma assinatura 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:To complete this quickstart, make sure you have:

  • Um computador Windows ou macOS com 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 executando no macOS, instale o Git por meio do HomeBrew.If running on macOS, get Git installed via HomeBrew. Digite o comando a seguir 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, execute brew install git.Then, run brew install git.
    • Para compilar o exemplo NDK, você também precisará instalar o NDK e o CMake 3.6 ou superior das SDK Tools no 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 para desenvolvedor e compatível 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. Confira aqui para obter informações e instruções adicionais.See here for additional information and instructions.
  • Seu aplicativo deve ser destinado ao ARCore 1.11.0.Your app must target ARCore 1.11.0.

Criar um recurso Âncoras EspaciaisCreate a Spatial Anchors resource

Vá para o Portal do Azure.Go to the Azure portal.

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

Use a caixa de pesquisa para Âncoras Espaciais.Use the search box to search for Spatial Anchors.

Pesquisar Âncoras Espaciais

Selecione Âncoras Espaciais.Select Spatial Anchors. Na caixa de diálogo, selecione Criar.In the dialog box, select Create.

No caixa de diálogo Conta de Âncoras Espaciais:In the Spatial Anchors Account dialog box:

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

  • Selecione a assinatura que você deseja anexar o recurso.Select the subscription that you want to attach the resource to.

  • Crie um grupo de recursos, selecionando Criar novo.Create a resource group by selecting Create new. Denomine-o como myResourceGroup e selecione OK.Name it myResourceGroup and select OK. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Por exemplo, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.For example, you can choose to delete the entire resource group in one simple step later.

  • Selecione um local (região) para criar 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.

    Criar um recurso

Depois que o recurso é criado, o portal do Azure mostra que a implantação foi concluída.After the resource is created, Azure Portal will show that your deployment is complete. Clique em Ir para o recurso.Click Go to resource.

Implantação concluída

Em seguida, você pode exibir as propriedades do recurso.Then, you can view the resource properties. Copiar o valor de ID da conta em um editor de texto, pois você precisará dele mais tarde.Copy the resource's Account ID value into a text editor because you'll need it later.

Propriedades de recurso

Em Configurações, selecione Chave.Under Settings, select Key. Cópia do valor de Chave primária em um editor de texto.Copy the Primary key value into a text editor. Esse valor é o Account Key.This value is the Account Key. Você 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 existente do Android Studio e selecione o projeto localizado em Android/Java/.Select Open an existing Android Studio project and select the project located at Android/Java/.

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

A próxima etapa é configurar o aplicativo para usar o identificador 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.java.Open Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

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

Localize o campo SpatialAnchorsAccountId e substitua Set me pelo identificador de 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 nele e conecte-o ao computador 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 do Android Studio.Select Run from the Android Studio toolbar.

Botão Implantar e Executar do Android Studio

Selecione o dispositivo Android na caixa de diálogo Selecionar o 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 colocar uma âncora e fazer recall dela.Follow the instructions in the app to place and recall an anchor.

Interrompa o aplicativo, selecionando Parar na barra de ferramentas do Android Studio.Stop the app by selecting Stop from the Android Studio toolbar.

Botão Parar do Android Studio

Limpar recursosClean up resources

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir 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 do portal do Azure ou na página Inicial, selecione Grupos de Recursos e, na página Grupos de Recursos, selecione myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and on the Resource groups page, select myResourceGroup.

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

Selecione Excluir, digite myResourceGroup na caixa de texto e selecione Excluir.Select Delete, type myResourceGroup in the text box, and then select Delete.

Próximas etapasNext steps

Neste início rápido, você criou uma conta de Âncoras Espaciais.In this quickstart, you created a Spatial Anchors account. Em seguida, você configurou e implantou um aplicativo para salvar e fazer recall de âncoras espaciais.You then configured and deployed an app to save and recall spatial anchors. Para saber mais sobre como melhorar o aplicativo, de modo que ele possa compartilhar âncoras espaciais com outros dispositivos, continue no 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.