Execute o aplicativo de exemplo: Android - Xamarin (C#)

Este guia de início rápido aborda como executar o aplicativo de exemplo Azure Spatial Anchors para dispositivos Android usando Xamarin (C#). O Azure Spatial Anchors é um serviço de desenvolvedor multiplataforma que permite criar experiências de realidade mista usando objetos que persistem sua localização entre dispositivos ao longo do tempo. Quando terminar, você terá um aplicativo para Android que pode salvar e recuperar uma âncora espacial.

Saberá como:

  • Criar uma conta de Âncoras Espaciais
  • Configurar o identificador de conta e a chave de conta das Âncoras Espaciais
  • Implantar e executar em um dispositivo Android

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

Pré-requisitos

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

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.

Captura de ecrã a mostrar os resultados de uma pesquisa por Âncoras Espaciais.

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

No painel Conta de Âncoras Espaciais, faça o seguinte:

  • Insira um nome de recurso exclusivo usando caracteres alfanuméricos regulares.

  • Selecione a subscrição à qual pretende anexar o recurso.

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

  • Selecione um local (região) no qual colocar o recurso.

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

Captura de ecrã do painel Âncoras Espaciais para criar um recurso.

Depois que o recurso é criado, o portal do Azure mostra que sua implantação foi concluída.

Captura de tela mostrando que a implantação do recurso foi concluída.

Selecione Ir para recurso. Agora você pode exibir as propriedades do recurso.

Copie o valor de ID de conta do recurso em um editor de texto para uso posterior.

Captura de ecrã do painel de propriedades do recurso.

Copie também o valor Domínio da Conta do recurso em um editor de texto para uso posterior.

Captura de ecrã a mostrar o valor do domínio da conta do recurso.

Em Configurações, selecione Chave de acesso. Copie o valor da chave primária, Chave de conta, em um editor de texto para uso posterior.

Captura de ecrã do painel Chaves da conta.

Abrir o projeto de exemplo

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 Xamarin/SampleXamarin.sln no Visual Studio.

Configurar identificador de conta e chave

A próxima etapa é configurar o aplicativo para usar seu identificador de conta e chave de conta. Você os copiou em um editor de texto ao configurar o recurso Âncoras espaciais.

Abrir Xamarin/SampleXamarin.Common/AccountDetails.cs.

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

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

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

Implantar o aplicativo em seu dispositivo Android

Ligue o dispositivo Android, inicie sessão e ligue-o ao computador utilizando um cabo USB.

Defina o projeto de inicialização como SampleXamarin.Android, altere a Configuração da Solução para Liberar e selecione o dispositivo no qual deseja implantar na lista suspensa do seletor de dispositivos.

Captura de tela que mostra o menu para selecionar o projeto e o dispositivo no Windows.

Selecione Depurar>Iniciar depuração para implantar e iniciar seu aplicativo.

No aplicativo, selecione Básico para executar a demonstração e siga as instruções para colocar e recuperar uma âncora.

Captura de ecrã 1Captura de ecrã 2Captura de tela 3

Clean up resources (Limpar 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.

No menu do portal do Azure ou na página inicial , selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que você deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Próximos passos

Neste início rápido, você criou uma conta de Âncoras Espaciais. Em seguida, você configurou e implantou um aplicativo para salvar e recuperar âncoras espaciais. Para saber mais sobre como melhorar o aplicativo para que ele possa compartilhar âncoras espaciais com outros dispositivos, continue para o próximo tutorial.