Tutorial: Compartilhar âncoras espaciais entre sessões e dispositivos

As Âncoras Espaciais do Azure são um serviço de desenvolvedor multiplataforma com o qual você pode criar experiências de realidade misturada usando objetos que persistem sua localização entre dispositivos ao longo do tempo.

Neste tutorial, você usa as Âncoras Espaciais do Azure para criar âncoras durante uma sessão e, depois, localizá-las, no mesmo dispositivo ou em um diferente. As mesmas âncoras também podem ser localizadas por vários dispositivos no mesmo lugar e ao mesmo tempo.

Neste tutorial, você aprenderá como:

• Implantar um aplicativo Web ASP.NET Core no Azure que possa ser usado para compartilhar âncoras e armazenar as âncoras na memória por um período de tempo especificado.
• Configurar a cena AzureSpatialAnchorsLocalSharedDemo dentro do exemplo do Unity de nossos inícios rápidos para aproveitar o aplicativo Web de Compartilhamento de Âncoras.
• Implantar e executar as âncoras em um ou mais dispositivos.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Pré-requisitos

Antes de iniciar este tutorial, verifique se você atendeu aos seguintes pré-requisitos:

• Leia a Visão geral de Âncoras Espaciais do Azure.
• Conclua um dos inícios rápidos de cinco minutos.

  Observação

  Os guias de início rápido do Android/NDK e do iOS/Swift atualmente não mostram as funcionalidades explicadas neste tutorial.

• Um conhecimento básico de:
  • ARCore se você estiver usando o Android.
  • ARKit se você estiver usando o iOS.
• Um computador Windows, com o Visual Studio 2019 ou posterior e a carga de trabalho ASP.NET e desenvolvimento Web.
• O SDK do .NET Core 3.1.
• Um ou mais dos seguintes dispositivos para implantar e executar um aplicativo: HoloLens, HoloLens 2, iOS ou Android.

Observação

Você usará o Unity e um aplicativo Web ASP.NET Core neste tutorial, mas essa abordagem é apenas para fornecer um exemplo de como compartilhar identificadores de Âncoras Espaciais do Azure em outros dispositivos. Você pode usar outras linguagens e tecnologias de back-end para atingir o mesmo objetivo.

Criar um recurso Âncoras Espaciais

Portal

Vá para o Portal do Azure.

No painel esquerdo, clique em Criar um recurso.

Use a caixa de pesquisa para Âncoras Espaciais.

Selecione Âncoras Espaciais e clique em Criar.

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

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

• Selecione a assinatura que você deseja anexar o recurso.

• Crie um grupo de recursos, selecionando Criar novo. Nomeie-o myResourceGroup e clique em 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, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.

• Selecione um local (região) para criar o recurso.

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

Depois que o recurso for criado, o portal do Azure mostrará que a implantação foi concluída.

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

Copie o valor da ID da Conta do recurso em um editor de texto para usar posteriormente.

Copie também o valor do Domínio de Contas do recurso em um editor de texto para usar posteriormente.

Em Configurações, selecione Chave de Acesso. Copie o valor da Chave primária, Chave de Conta, em um editor de texto para usar posteriormente.

CLI do Azure

Comece preparando seu ambiente para a CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

1. Depois de se conectar, use o comando az account set para escolher a assinatura na qual a conta de âncoras espaciais será configurada:

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

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

   az group create --name myResourceGroup --location eastus2
   

   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, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.

   Veja suas contas atuais de âncoras espaciais para um grupo de recursos usando o comando az spatial-anchors-account list:

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

   Veja também as contas de âncoras espaciais para sua assinatura:

   az spatial-anchors-account list
   

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

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

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

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

   Copie os valores de ID da Conta e Domínio da Conta do recurso em um editor de texto para uso posterior.

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

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

   Copie os valores das chaves em um editor de texto para uso posterior.

   Caso precise regenerar as chaves, use 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
   

Exclua uma conta usando o comando az spatial-anchors-account delete:

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

PowerShell do Azure

Comece preparando seu ambiente para o Azure PowerShell:

• Se você optar por usar o Azure PowerShell localmente:
  • Instale a versão mais recente do módulo do Az PowerShell.
  • Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount.
• Se você optar por usar o Azure Cloud Shell:
  • Confira Visão geral do Azure Cloud Shell para obter mais informações.

Importante

Enquanto o módulo Az.MixedReality do PowerShell estiver em versão prévia, você precisará instalá-lo separadamente usando o cmdlet Install-Module. Depois que esse módulo do PowerShell estiver em disponibilidade geral, ele fará parte das versões futuras do módulo Az PowerShell e estará disponível por padrão no Azure Cloud Shell.

Install-Module -Name Az.MixedReality

1. Depois de entrar, use o cmdlet Set-AzContext para escolher a assinatura na qual a conta de âncoras espaciais será configurada:

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

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

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   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, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.

   Veja suas contas atuais de âncoras espaciais para um grupo de recursos usando o cmdlet Get-AzSpatialAnchorsAccount:

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Veja também as contas de âncoras espaciais para sua assinatura:

   Get-AzSpatialAnchorsAccount
   

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

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

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

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie o valor de accountId da propriedade e o valor de accountDomain da propriedade em um editor de texto para uso posterior.

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

   Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie os valores das chaves em um editor de texto para uso posterior.

   Caso precise regenerar as chaves, use o cmdlet New-AzSpatialAnchorsAccountKey:

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

Exclua uma conta usando o cmdlet Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Baixe o projeto de amostra + SDK de importação

Clonar o Repositório de Exemplos

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

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

Importar SDK do ASA

Siga as instruções aqui para baixar e importar os pacotes do SDK do ASA necessários para a plataforma HoloLens.

Implantar o serviço de Compartilhamento de Âncoras

Observação

Neste tutorial, usaremos a camada gratuita do Serviço de Aplicativo do Azure. A camada gratuita atingirá o tempo limite após 20 minutos de inatividade e redefinirá o cache de memória.

Visual Studio

Abra o Visual Studio e, depois, abra o projeto na pasta Sharing\SharingServiceSample.

Abra o assistente de publicação

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto SharingService e selecione Publicar....

O assistente de publicação inicia.

1. Selecione o DestinoAzure>Avançar.
2. Selecione como o Destino específico o Serviço de Aplicativo do Azure (Windows)>Avançar
3. Entre no portal do Azure.
4. Selecione o verde "+" para Criar um Serviço de Aplicativo do Azure

Configurações do Serviço de Aplicativo

Configuração	Valor sugerido	Description
Nome	myASASharingService	Forneça um nome exclusivo ao serviço
Nome da assinatura		Selecione a sua assinatura preferida do Azure
Grupo de recursos	myResourceGroup ou selecione um existente	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, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.
Plano de Hospedagem	Selecione Novo... e veja a tabela abaixo	Um plano do Serviço de Aplicativo especifica o local, tamanho e recursos do farm de servidores Web que hospeda o aplicativo. É possível economizar dinheiro ao hospedar vários aplicativos configurando os aplicativos Web para compartilhar um plano do Serviço de Aplicativo. Os Planos do Serviço de Aplicativo definem: Região (por exemplo: Norte da Europa, Leste dos EUA ou Sudeste Asiático) Tamanho da instância (pequena, média ou grande) Contagem da escala (1 a 20 instâncias) SKU (Gratuito, Compartilhado, Básico, Standard ou Premium)

Configurações do plano de hospedagem

Configuração	Valor sugerido	Descrição
Plano de Hospedagem	MySharingServicePlan	Forneça ao seu plano de hospedagem um nome exclusivo
Location	Oeste dos EUA	O datacenter onde o aplicativo Web está hospedado. Escolha um local mais próximo do local físico que seu aplicativo será usado
Tamanho	Grátis	O tipo de preço que determina os recursos de hospedagem

5. Selecione Criar para criar o Serviço de Aplicativo
6. Depois que o serviço de aplicativo for criado, selecione-o na lista "Instâncias do serviço de aplicativo" e selecione Concluir
7. Na guia SharingService: Publicar, selecione Publicar

Depois que o aplicativo Web do ASP.NET Core tiver sido publicado no Azure, você poderá acessar https://<your_app_name>.azurewebsites.net ou clicar no link ao lado do Site: na guia SharingService: Publicar. Copie essa URL para um editor de texto para uso posterior.

Visual Studio Code

Você precisa criar um grupo de recursos e um plano do Serviço de Aplicativo para implantar o serviço no Visual Studio Code.

Entrar no Azure

Acesse o portal do Azure e entre em sua assinatura do Azure.

Criar um grupo de recursos

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, é possível excluir posteriormente todo o grupo de recursos com uma única etapa simples.

Ao lado de Grupo de recursos, selecione Novo.

Nomeie o grupo de recursos como myResourceGroup e selecione Ok.

Criar um plano de Serviço de Aplicativo

Um plano do Serviço de Aplicativo especifica o local, tamanho e recursos do farm de servidores Web que hospeda o aplicativo. É possível economizar dinheiro ao hospedar vários aplicativos configurando os aplicativos Web para compartilhar um plano do Serviço de Aplicativo.

Os Planos do Serviço de Aplicativo definem:

• Região (por exemplo: Norte da Europa, Leste dos EUA ou Sudeste Asiático)
• Tamanho da instância (pequena, média ou grande)
• Contagem da escala (1 a 20 instâncias)
• SKU (Gratuito, Compartilhado, Básico, Standard ou Premium)

Ao lado de Plano de Hospedagem, selecione Novo.

No painel Configurar Plano de Hospedagem, use essas configurações:

Configuração	Valor sugerido	Descrição
Plano do Serviço de Aplicativo	MySharingServicePlan	Nome do plano do Serviço de Aplicativo
Location	Oeste dos EUA	O datacenter em que o aplicativo Web está hospedado
Tamanho	Grátis	O tipo de preço que determina os recursos de hospedagem

Selecione OK.

Abra o Visual Studio Code e, depois, abra o projeto na pasta Sharing\SharingServiceSample.

Para implantar o serviço de compartilhamento por meio do Visual Studio Code, siga as instruções em Publicar um aplicativo ASP.NET Core no Azure com Visual Studio Code. Inicie na seção "Abrir com o Visual Studio Code". Não crie outro projeto ASP.NET, conforme explicado na etapa anterior, porque você já tem um projeto a ser implantado e publicado: SharingServiceSample.

Configurar + implantar o aplicativo de exemplo

Unity - HoloLens

Abrir Projeto

No Unity, abra o projeto na pasta Unity. O Unity poderá avisar que há uma diferença entre a versão do projeto e a versão instalada em seu computador. Esse aviso não é incomum, contanto que sua versão do Editor do Unity seja mais recente do que aquela em que o projeto foi criado. Caso sua versão seja mais recente, clique em Continuar. Caso sua versão seja mais antiga do que a exigida pelo projeto, clique em Sair e atualize o Editor do Unity.

Definir configurações de compilação

Abra Configurações de Build selecionando Arquivo>Configurações de Build.

Na seção Plataforma, selecione Plataforma Universal do Windows. Altere o Dispositivo de Destino para HoloLens.

Selecione Alternar Plataforma para alterar a plataforma para a Plataforma Universal do Windows. O Unity poderá solicitar que você instale componentes de suporte UWP, se estiverem faltando.

Feche a janela Configurações de Build.

Configurar as informações da conta

A próxima etapa será configurar o aplicativo para usar as informações da conta. Você copiou os valores de Chave de Conta, ID da Conta e Domínio de Contas em um editor de texto anteriormente, na seção "Criar um recurso de Âncoras Espaciais".

No painel Projeto, acesse Assets\AzureSpatialAnchors.SDK\Resources.

Clique em SpatialAnchorConfig. No painel Inspetor, insira o Account Key como o valor para a Chave de Conta de Âncoras Espaciais, o Account ID como o valor para a ID da Conta de Âncoras Espaciais e o Account Domain como o valor para o Domínio de Contas de Âncoras Espaciais.

Abra a Cena chamada AzureSpatialAnchorsLocalSharedDemo encontrada Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo clicando duas vezes nele no painel do projeto

No painel Projeto, acesse Assets\AzureSpatialAnchors.Examples\Resources.

Selecione SpatialAnchorSamplesConfig. Em seguida, no painel Inspetor, insira a URL Sharing Anchors Service (de sua implantação do Azure do aplicativo Web ASP.NET) como o valor para Base Sharing Url. Anexe o URL com /swagger/api/anchors. O resultado deve ser assim: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Salve a cena selecionando Arquivo>Salvar.

Exportar + implantar o aplicativo HoloLens

Abra Configurações de Build selecionando Arquivo>Configurações de Build.

Sob Cenas em compilação, verifique se todas as cenas tem uma marca de seleção ao lado deles.

Selecione Compilar. Na caixa de diálogo, selecione uma pasta para exportar o projeto do Visual Studio do HoloLens.

Quando a exportação estiver concluída, uma pasta contendo o projeto HoloLens exportado será exibida.

Na pasta, clique duas vezes em HelloAR U3D.sln para abrir o projeto no Visual Studio.

Altere a Configuração da Solução para Lançamento, altere a Plataforma da Solução para x86 e selecione Dispositivo das opções de destino de implantação.

Se estiver usando o HoloLens 2, use o ARM64 como a Plataforma de Solução, em vez de x86.

Ligue o dispositivo do HoloLens, entre e conecte o dispositivo ao computador usando um cabo USB.

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

Executar o aplicativo

No aplicativo, selecione LocalSharedDemo usando as setas e pressione o botão Ir! para executar a demonstração. Siga as instruções para colocar uma âncora e fazer recall dela.

Com Criar e Compartilhar Âncora, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá um identificador para ela que pode ser usado para recuperá-la do serviço de compartilhamento. Em seguida, você poderá executar o segundo cenário, Localizar Âncora Compartilhada, em seu dispositivo ou em um dispositivo diferente.

Com Localizar Âncora Compartilhada, você pode localizar as âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o cenário, o aplicativo fornecerá mais instruções. Por exemplo, você será solicitado a mover seu dispositivo para coletar informações sobre o ambiente. Mais adiante, você colocará uma âncora no mundo. Aguarde até que ela seja salva, inicie uma sessão e a localize.

Unity - Android

Abrir Projeto

No Unity, abra o projeto na pasta Unity. O Unity poderá avisar que há uma diferença entre a versão do projeto e a versão instalada em seu computador. Esse aviso não é incomum, contanto que sua versão do Editor do Unity seja mais recente do que aquela em que o projeto foi criado. Caso sua versão seja mais recente, clique em Continuar. Caso sua versão seja mais antiga do que a exigida pelo projeto, clique em Sair e atualize o Editor do Unity.

Definir configurações de compilação

Abra Configurações de Build selecionando Arquivo>Configurações de Build.

Na seção Plataforma, clique em Android e selecione Alternar a Plataforma com o objetivo de alterar a plataforma para Android. O Unity poderá solicitar que você instale componentes de suporte Android, se estiverem faltando.

Feche a janela Configurações de Build.

Configurar as informações da conta

A próxima etapa será configurar o aplicativo para usar as informações da conta. Você copiou os valores de Chave de Conta, ID da Conta e Domínio de Contas em um editor de texto anteriormente, na seção "Criar um recurso de Âncoras Espaciais".

No painel Projeto, acesse Assets\AzureSpatialAnchors.SDK\Resources.

Clique em SpatialAnchorConfig. No painel Inspetor, insira o Account Key como o valor para a Chave de Conta de Âncoras Espaciais, o Account ID como o valor para a ID da Conta de Âncoras Espaciais e o Account Domain como o valor para o Domínio de Contas de Âncoras Espaciais.

Abra a Cena chamada AzureSpatialAnchorsLocalSharedDemo encontrada Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo clicando duas vezes nele no painel do projeto

No painel Projeto, acesse Assets\AzureSpatialAnchors.Examples\Resources.

Selecione SpatialAnchorSamplesConfig. Em seguida, no painel Inspetor, insira a URL Sharing Anchors Service (de sua implantação do Azure do aplicativo Web ASP.NET) como o valor para Base Sharing Url. Anexe o URL com /swagger/api/anchors. O resultado deve ser assim: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Salve a cena selecionando Arquivo>Salvar.

Implantar

Entre no dispositivo Android e conecte-o em seu computador usando um cabo USB.

Abra Configurações de Build selecionando Arquivo>Configurações de Build.

Em Cenas no Build, verifique se cada cena tem a marca de seleção ao lado dela.

A opção Exportar Projeto não deve ter a marca de seleção. Selecione Compilar e Executar. Você será solicitado a salvar o arquivo .apk. Você pode escolher qualquer nome para ele.

Executar o aplicativo

No aplicativo, selecione a demonstração do LocalShare usando as setas e pressione o botão Ir! para executar a demonstração. Siga as instruções para colocar uma âncora e fazer recall dela.

Com Criar e Compartilhar Âncora, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá um identificador para ela que pode ser usado para recuperá-la do serviço de compartilhamento. Em seguida, você poderá executar o segundo cenário, Localizar Âncora Compartilhada, em seu dispositivo ou em um dispositivo diferente.

Com Localizar Âncora Compartilhada, você pode localizar as âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o cenário, o aplicativo fornecerá mais instruções. Por exemplo, você será solicitado a mover seu dispositivo para coletar informações sobre o ambiente. Mais adiante, você colocará uma âncora no mundo. Aguarde até que ela seja salva, inicie uma sessão e a localize.

Unity - iOS

Abrir Projeto

No Unity, abra o projeto na pasta Unity. O Unity poderá avisar que há uma diferença entre a versão do projeto e a versão instalada em seu computador. Esse aviso não é incomum, contanto que sua versão do Editor do Unity seja mais recente do que aquela em que o projeto foi criado. Caso sua versão seja mais recente, clique em Continuar. Caso sua versão seja mais antiga do que a exigida pelo projeto, clique em Sair e atualize o Editor do Unity.

Definir configurações de compilação

Abra Configurações de Build selecionando Arquivo>Configurações de Build.

Na seção Plataforma, selecione iOS.

Selecione Mudar Plataforma para alterar a plataforma para iOS. O Unity poderá solicitar que você instale componentes de suporte iOS, se estiverem faltando.

Feche a janela Configurações de Build.

Configurar as informações da conta

A próxima etapa será configurar o aplicativo para usar as informações da conta. Você copiou os valores de Chave de Conta, ID da Conta e Domínio de Contas em um editor de texto anteriormente, na seção "Criar um recurso de Âncoras Espaciais".

No painel Projeto, acesse Assets\AzureSpatialAnchors.SDK\Resources.

Clique em SpatialAnchorConfig. No painel Inspetor, insira o Account Key como o valor para a Chave de Conta de Âncoras Espaciais, o Account ID como o valor para a ID da Conta de Âncoras Espaciais e o Account Domain como o valor para o Domínio de Contas de Âncoras Espaciais.

Abra a Cena chamada AzureSpatialAnchorsLocalSharedDemo encontrada Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo clicando duas vezes nele no painel do projeto

No painel Projeto, acesse Assets\AzureSpatialAnchors.Examples\Resources.

Selecione SpatialAnchorSamplesConfig. Em seguida, no painel Inspetor, insira a URL Sharing Anchors Service (de sua implantação do Azure do aplicativo Web ASP.NET) como o valor para Base Sharing Url. Anexe o URL com /swagger/api/anchors. O resultado deve ser assim: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Salve a cena selecionando Arquivo>Salvar.

Implantar em um dispositivo iOS

Abra Configurações de Build selecionando Arquivo>Configurações de Build.

Em Cenas no Build, verifique se cada cena tem a marca de seleção ao lado dela.

Selecione Compilar. No painel que será aberto, selecione uma pasta para exportar o projeto do Xcode.

Depois que a exportação for concluída, a pasta que contém o projeto do Xcode exportado será exibida.

Observação

Caso uma janela apareça com uma mensagem perguntando se você deseja substituir ou acrescentar, recomendamos clicar em Acrescentar porque essa é a opção mais rápida. Substituir removerá todos os arquivos da pasta de destino e gerará um conteúdo novo.

Abrir o projeto do Xcode

Agora você pode abrir o projeto Unity-iPhone.xcodeproj no Xcode.

É possível iniciar o Xcode e abrir o projeto Unity-iPhone.xcodeproj exportado ou iniciar o projeto no Xcode executando o seguinte comando na localização em que você exportou o projeto:

open ./Unity-iPhone.xcodeproj

Selecione o nó raiz Unity-iPhone para exibir as configurações do projeto e, em seguida, selecione a guia Geral.

Em Informações sobre a implantação, verifique se o destino da implantação está definido como iOS 11.0.

Selecione a guia Assinatura e Recursos, bem como verifique se a opção Gerenciar assinatura de modo automático está habilitada. Caso contrário, habilite a opção e redefina as configurações de build selecionando Habilitação Automática no painel que aparecer.

Implantar o aplicativo em seu dispositivo iOS

Conecte o dispositivo iOS ao Mac e defina o esquema ativo para seu dispositivo iOS.

Selecione Compilar e, em seguida, executar o esquema atual.

Executar o aplicativo

No aplicativo, selecione a demonstração do LocalShare usando as setas e pressione o botão Ir! para executar a demonstração. Siga as instruções para colocar uma âncora e fazer recall dela.

Com Criar e Compartilhar Âncora, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá um identificador para ela que pode ser usado para recuperá-la do serviço de compartilhamento. Em seguida, você poderá executar o segundo cenário, Localizar Âncora Compartilhada, em seu dispositivo ou em um dispositivo diferente.

Com Localizar Âncora Compartilhada, você pode localizar as âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o cenário, o aplicativo fornecerá mais instruções. Por exemplo, você será solicitado a mover seu dispositivo para coletar informações sobre o ambiente. Mais adiante, você colocará uma âncora no mundo. Aguarde até que ela seja salva, inicie uma sessão e a localize.

No Xcode, interrompa o aplicativo selecionando Parar.

Android

O exemplo do Java Android é compatível com o compartilhamento entre dispositivos.

No Android Studio, abra o arquivo SharedActivity.java da pasta de exemplos.

Insira a URL que você copiou na etapa anterior (em sua implantação do Azure do aplicativo Web ASP.NET) como o valor de SharingAnchorsServiceUrl no arquivo SharedActivity.java.

Substitua o index.html na URL por api/anchors. O resultado deve ser assim: https://<app_name>.azurewebsites.net/api/anchors.

Implante o aplicativo em seu dispositivo.

Depois que o aplicativo é iniciado, no painel Escolher Uma Demonstração, use as setas à esquerda e direita para selecionar a opção LocalShare. Em seguida, toque em Ir! .

Siga as instruções no aplicativo. Você pode optar por Criar e Compartilhar Âncora ou Localizar Âncora Compartilhada.

Com Criar e Compartilhar Âncora, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá um identificador para ela que pode ser usado para recuperá-la do serviço de compartilhamento. Em seguida, você poderá executar o segundo cenário, Localizar Âncora Compartilhada, em seu dispositivo ou em um dispositivo diferente.

Com Localizar Âncora Compartilhada, você pode localizar as âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o cenário, o aplicativo fornecerá mais instruções. Por exemplo, você será solicitado a mover seu dispositivo para coletar informações sobre o ambiente. Mais adiante, você colocará uma âncora no mundo. Aguarde até que ela seja salva, inicie uma sessão e a localize.

iOS

O exemplo do iOS Objective-C dá suporte ao compartilhamento entre dispositivos.

Abra o arquivo SharedDemoViewController.m na pasta de exemplos.

Insira a URL obtida na etapa anterior (em sua implantação do Azure do aplicativo Web ASP.NET) como o valor de SharingAnchorsServiceUrl no arquivo SharedDemoViewController.m.

Substitua o index.html na URL por api/anchors. O resultado deve ser assim: https://<app_name>.azurewebsites.net/api/anchors.

Implante o aplicativo em seu dispositivo.

Depois que o aplicativo for iniciado, selecione a opção Toque para iniciar a demonstração compartilhada e siga as instruções no aplicativo. Selecione Toque para localizar a Âncora pelo número de âncora ou Toque para criar uma Âncora e salvá-la no serviço.

Com Criar e Compartilhar Âncora, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá um identificador para ela que pode ser usado para recuperá-la do serviço de compartilhamento. Em seguida, você poderá executar o segundo cenário, Localizar Âncora Compartilhada, em seu dispositivo ou em um dispositivo diferente.

Com Localizar Âncora Compartilhada, você pode localizar as âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o cenário, o aplicativo fornecerá mais instruções. Por exemplo, você será solicitado a mover seu dispositivo para coletar informações sobre o ambiente. Mais adiante, você colocará uma âncora no mundo. Aguarde até que ela seja salva, inicie uma sessão e a localize.

Xamarin

Os exemplos do Xamarin Android e iOS dão suporte ao compartilhamento entre dispositivos.

Abra o arquivo AccountDetails.cs na pasta de exemplos.

Insira a URL obtida na etapa anterior (em sua implantação do Azure do aplicativo Web ASP.NET) como o valor de AnchorSharingServiceUrl no arquivo AccountDetails.cs.

Substitua o index.html na URL por api/anchors. O resultado deve ser assim: https://<app_name>.azurewebsites.net/api/anchors.

Implante o aplicativo em seu dispositivo.

Depois que o aplicativo é iniciado, no painel Escolher Uma Demonstração, use as setas à esquerda e direita para selecionar a opção LocalShare. Em seguida, toque em Ir! .

Siga as instruções no aplicativo. Você pode optar por Criar e Compartilhar Âncora ou Localizar Âncora Compartilhada.

Com Criar e Compartilhar Âncora, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá um identificador para ela que pode ser usado para recuperá-la do serviço de compartilhamento. Em seguida, você poderá executar o segundo cenário, Localizar Âncora Compartilhada, em seu dispositivo ou em um dispositivo diferente.

Com Localizar Âncora Compartilhada, você pode localizar as âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o cenário, o aplicativo fornecerá mais instruções. Por exemplo, você será solicitado a mover seu dispositivo para coletar informações sobre o ambiente. Mais adiante, você colocará uma âncora no mundo. Aguarde até que ela seja salva, inicie uma sessão e a localize.

Limpar os recursos

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir 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 deseja excluir.

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

Próximas etapas

Neste tutorial, você implantou um aplicativo Web do ASP.NET Core no Azure e, então, configurou e implantou um aplicativo Unity. Você criou âncoras espaciais com o aplicativo e as compartilhou com outros dispositivos usando seu aplicativo Web ASP.NET Core.

Você pode aprimorar o aplicativo Web ASP.NET Core para que ele use o Azure Cosmos DB para persistir o armazenamento dos identificadores de âncoras espaciais compartilhadas. Ao adicionar suporte ao Azure Cosmos DB, você pode fazer com que seu aplicativo Web ASP.NET Core crie uma âncora hoje mesmo. Em seguida, usando o identificador de âncora armazenado no aplicativo Web, você pode fazer com que o aplicativo retorne dias mais tarde para localizar a âncora novamente.

Usar o Azure Cosmos DB para armazenar âncoras