Executar a aplicação de exemplo: Android - Xamarin (C#)

Este início rápido aborda como executar a aplicação de exemplo Âncoras Espaciais do Azure para dispositivos Android com Xamarin (C#). O Azure Spatial Anchors é um serviço de programador de várias plataformas que lhe permite criar experiências de realidade mista com objetos que persistem na sua localização nos dispositivos ao longo do tempo. Quando terminar, terá uma aplicação Android que pode guardar e recuperar uma âncora espacial.

Vai aprender a:

• Criar uma conta de Âncoras Espaciais
• Configurar o identificador de conta e a chave de conta do Spatial Anchors
• Implementar e executar num 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:

• Um computador Windows ou macOS:
  • Se estiver a utilizar o Windows:
    • Uma versão atualizada do Visual Studio 2019 16.2+.
    • Git para Windows.
    • Git LFS.
  • Se estiver a utilizar o macOS:
    • Uma versão atualizada do Visual Studio para Mac 8.1+.
    • Git para macOS.
    • Git LFS.
• A versão mais recente do Xamarin.Android instalada e em execução na sua plataforma de eleição. Para obter um guia para instalar o Xamarin.Android, consulte os Guias de Instalação Xamarin.Android .
• Um programador ativado e um dispositivo Android compatível com ARCore .
  • Podem ser necessários controladores de dispositivo adicionais para que o seu computador comunique com o seu dispositivo Android. Para obter mais informações, veja aqui.
• A sua aplicação tem de ter como destino ARCore 1.8.

Criar um recurso de Âncoras Espaciais

Portal

Aceda ao Portal do Azure.

No painel esquerdo, selecione Criar um recurso.

Utilize a caixa de pesquisa para procurar Âncoras Espaciais.

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

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

• Introduza um nome de recurso exclusivo com carateres alfanuméricos normais.

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

• Crie um grupo de recursos ao selecionar Criar novo. Dê-lhe o nome myResourceGroup e, em seguida, selecione OK.

  Um grupo de recursos é um contentor lógico no qual os recursos do Azure, como aplicações Web, bases de dados e contas de armazenamento, são implementados 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 colocar o recurso.

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

Após a criação do recurso, o portal do Azure mostra que a implementação está concluída.

Selecione Ir para recurso. Agora pode ver as propriedades do recurso.

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

Copie também o valor do Domínio de Conta do recurso para um editor de texto para utilização posterior.

Em Definições, selecione Chave de Acesso. Copie o valor da chave primária , Chave de Conta, para um editor de texto para utilização posterior.

CLI do Azure

Comece por preparar o seu ambiente para a CLI do Azure:

• Utilize o ambiente bash no Azure Cloud Shell. Para obter mais informações, veja Início Rápido do Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, veja Como executar a CLI do Azure num contentor do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de início de sessão, veja Iniciar sessão com a CLI do Azure.

  • Quando lhe for pedido, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

1. Depois de iniciar sessão, utilize o comando az account set para selecionar a subscrição na qual pode configurar a conta de âncoras espaciais:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Execute o comando az group create para criar um grupo de recursos ou utilize um grupo de recursos existente:

   az group create --name myResourceGroup --location eastus2
   

   Um grupo de recursos é um contentor lógico no qual os recursos do Azure, como aplicações Web, bases de dados e contas de armazenamento, são implementados e geridos. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

   Pode ver as suas contas de âncoras espaciais atuais para um grupo de recursos com o comando az spatial-anchors-account list :

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Também pode ver as contas de âncoras espaciais da sua subscrição:

   az spatial-anchors-account list
   

3. Execute o comando az spatial-anchors-account create para criar a sua conta de âncoras espaciais:

   az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2
   

4. Veja as propriedades do recurso com o comando az spatial-anchors-account show :

   az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Copie o valor do ID da Conta do recurso e o valor de Domínio da Conta de recurso para um editor de texto para utilização posterior.

5. Execute o comando az spatial-anchors-account key show para obter as chaves primárias e secundárias:

   az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
   

   Copie os valores de chave para um editor de texto para utilização posterior.

   Se precisar de regenerar chaves, utilize o comando az spatial-anchors-account key renew :

   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
   az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
   

Pode eliminar uma conta com o comando az spatial-anchors-account delete :

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Azure PowerShell

Comece por preparar o seu ambiente para o Azure PowerShell:

• Se optar por utilizar Azure PowerShell localmente:
  • Instale a versão mais recente do módulo do Az PowerShell.
  • Ligue-se à sua conta do Azure com o cmdlet Connect-AzAccount .
• Se optar por utilizar o Azure Cloud Shell:
  • Veja Descrição geral do Azure Cloud Shell para obter mais informações.

Importante

Enquanto o módulo Az.MixedReality PowerShell está em pré-visualização, tem de instalá-lo separadamente com o Install-Module cmdlet. Quando este módulo do PowerShell entrar em disponibilidade geral, fará parte das versões futuras do módulo Az PowerShell e estará disponível por predefinição a partir do Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Depois de iniciar sessão, utilize o cmdlet Set-AzContext para selecionar a subscrição para configurar a conta de âncoras espaciais:

   Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
   

2. Execute o cmdlet New-AzResourceGroup para criar um grupo de recursos ou utilize um grupo de recursos existente:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   Um grupo de recursos é um contentor lógico no qual os recursos do Azure, como aplicações Web, bases de dados e contas de armazenamento, são implementados e geridos. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

   Pode ver as suas contas de âncoras espaciais atuais para um grupo de recursos com o cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Também pode ver as contas de âncoras espaciais da sua subscrição:

   Get-AzSpatialAnchorsAccount
   

3. Execute o cmdlet New-AzSpatialAnchorsAccount para criar a sua conta de âncoras espaciais:

   New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2
   

4. Veja as propriedades do recurso com o cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie o valor accountId da propriedade e o valor accountDomain de propriedade para um editor de texto para utilização posterior.

5. Execute o cmdlet Get-AzSpatialAnchorsAccountKey para obter as chaves primárias e secundárias:

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie os valores de chave para um editor de texto para utilização posterior.

   Se precisar de regenerar chaves, utilize o cmdlet New-AzSpatialAnchorsAccountKey :

   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
   New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary
   

Pode eliminar uma conta com o cmdlet Remove-AzSpatialAnchorsAccount :

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Abrir o projeto de exemplo

Clone o repositório de exemplos ao executar 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 o identificador e a chave da conta

O próximo passo é configurar a aplicação para utilizar o identificador de conta e a chave de conta. Copiou-os para um editor de texto ao configurar o recurso Âncoras Espaciais.

Abra Xamarin/SampleXamarin.Common/AccountDetails.cs.

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

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

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

Implementar a aplicação no seu dispositivo Android

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

Defina o projeto de arranque como SampleXamarin.Android, altere a Configuração da Solução para Lançamento e selecione o dispositivo para o qual pretende implementar no menu pendente do seletor de dispositivos.

Windows

Selecione Depurar>Iniciar depuração para implementar e iniciar a sua aplicação.

macOS

Selecione Executar>Iniciar Sem Depuração para implementar e iniciar a sua aplicação.

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

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.

No menu portal do Azure ou home page, 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 os que pretende eliminar.

Selecione Eliminar grupo de recursos, escreva myResourceGroup na caixa de texto a confirmar e, em seguida, selecione Eliminar.

Passos seguintes

Neste início rápido, criou uma conta de Âncoras Espaciais. Em seguida, configurou e implementou uma aplicação para guardar e recuperar âncoras espaciais. Para saber mais sobre como melhorar a aplicação para poder partilhar âncoras espaciais com outros dispositivos, avance para o próximo tutorial.

Tutorial: Partilhar Âncoras Espaciais entre dispositivos