Executar o aplicativo de amostra: Android - Android Studio (Java ou C++/NDK)

Este quickstart cobre como executar a aplicação de amostra de Azure Spatial Anchors para dispositivos Android usando Android Studio (Java ou C++/NDK). Azure Spatial Anchors é um serviço de desenvolvedores 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. Quando terminar, terá uma aplicação ARCore Android que pode guardar e recordar uma âncora espacial.

Vai aprender a:

  • Criar uma conta de Âncoras Espaciais
  • Configure o identificador de conta Spatial Anchors e a chave de conta
  • Implementar e executar num dispositivo Android

Se não tiver uma subscrição do Azure, crie uma conta Azure gratuita antes de começar.

Pré-requisitos

Para concluir este início rápido, certifique-se de que tem:

  • Uma máquina Windows ou macOS com Android Studio 3.4+.
    • Se estiver a funcionar no Windows, também necessitará de Git para Windows e Git LFS.
    • Se estiver a funcionar com macOS, instale o Git via HomeBrew. Introduza o seguinte comando numa única linha do Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Então, corra brew install git e brew install git-lfs.
    • Para construir a amostra NDK, também terá de instalar as Ferramentas NDK e CMake 3.6 ou maiores no Android Studio.
  • Um dispositivo Android habilitado para o desenvolvedor e capaz de ARCore .
    • Podem ser necessários controladores de dispositivos adicionais para que o seu computador comunique com o seu dispositivo Android. Consulte aqui informações e instruções adicionais.
  • A sua aplicação tem como alvo ARCore 1.11.0.

Criar um recurso de âncoras espaciais

Aceda ao Portal do Azure.

No painel esquerdo, selecione Criar um recurso.

Use a caixa de pesquisa para procurar âncoras espaciais.

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

Selecione Âncoras Espaciais e, em seguida, selecione Criar.

No painel de contas das âncoras espaciais , faça o seguinte:

  • Introduza um nome de recurso único utilizando caracteres alfanuméricos regulares.

  • Selecione a subscrição a que pretende anexar o recurso.

  • Criar um grupo de recursos selecionando Criar novo. Nomeie-o no myResourceGroup e, em seguida, selecione 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. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

  • Selecione uma localização (região) na qual coloque o recurso.

  • Selecione Criar para começar a criar o recurso.

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

Após a criação do recurso, o portal do Azure mostra que a sua implantação está completa.

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

Selecione Ir para recurso. Agora pode ver as propriedades dos recursos.

Copie o valor de ID da conta do recurso num editor de texto para posterior utilização.

Screenshot do painel de propriedades de recursos.

Também copie o valor do Domínio da Conta do recurso num editor de texto para posterior utilização.

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

Em Definições, selecione A Tecla de acesso. Copie o valor da chave principal , Chave de Conta, num editor de texto para posterior utilização.

Screenshot do painel keys para a conta.

Abra o projeto de amostra

Clone o repositório de amostras executando os seguintes comandos:

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

Abra o Android Studio.

Selecione Abrir um projeto Android Studio existente e selecione o projeto localizado em Android/Java/.

Configure identificador de conta e chave

O próximo passo é configurar a app para usar o identificador de conta e a chave da conta. Copiou-os para um editor de texto ao configurar o recurso "Âncoras Espaciais".

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

Localize o SpatialAnchorsAccountKey campo e substitua-o Set me pela chave de conta.

Localize o SpatialAnchorsAccountId campo e substitua-o Set me pelo identificador de conta.

Localize o SpatialAnchorsAccountDomain campo e substitua-o Set me pelo domínio da conta.

Implemente a aplicação para o seu dispositivo Android

Ligue o dispositivo Android, inscreva-se e conecte-o ao PC utilizando um cabo USB.

Selecione Executar a partir da barra de ferramentas Android Studio.

Android Studio Implementar e Executar

Selecione o dispositivo Android no diálogo Select Deployment Target e selecione OK para executar a aplicação no dispositivo Android.

Siga as instruções na aplicação para colocar e lembre-se de uma âncora.

Pare a aplicação selecionando Stop a partir da barra de ferramentas Android Studio.

Paragem do estúdio Android

Limpar os recursos

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.

A partir do menu portal do Azure ou página inicial, selecione grupos de Recursos. Em seguida, na página de grupos de recursos , selecione myResourceGroup.

Na página myResourceGroup , certifique-se de que os recursos listados são os que pretende eliminar.

Selecione Eliminar o grupo de recursos, digite o myResourceGroup na caixa de texto para confirmar e, em seguida, selecione Delete.

Passos seguintes

Neste arranque rápido, criaste uma conta espacial. Em seguida, configuraste e implementou uma aplicação para guardar e recordar âncoras espaciais. Para saber mais sobre como melhorar a app para que possa partilhar âncoras espaciais com outros dispositivos, continue para o próximo tutorial.