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

O Azure Spatial Anchors é um serviço de desenvolvedor multiplataforma com o qual você pode criar experiências de realidade mista 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, em seguida, localizá-las no mesmo dispositivo ou em um dispositivo diferente. As mesmas âncoras também podem ser localizadas por vários dispositivos no mesmo lugar e ao mesmo tempo.

Neste tutorial, irá aprender a:

• Implante um aplicativo Web ASP.NET Core no Azure que você pode usar para compartilhar âncoras e armazenar as âncoras na memória por um período de tempo especificado.
• Configure a cena AzureSpatialAnchorsLocalSharedDemo dentro do exemplo Unity em nossos inícios rápidos para aproveitar o aplicativo Web Sharing Anchors.
• Implante e execute as âncoras em um ou mais dispositivos.

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

Pré-requisitos

Antes de começar este tutorial, certifique-se de que cumpriu os seguintes pré-requisitos:

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

  Nota

  Os inícios rápidos Android/NDK e iOS/Swift atualmente não mostram os recursos explicados neste tutorial.

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

Nota

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

Criar um recurso de Âncoras Espaciais

Portal

Aceda ao portal do Azure.

No painel esquerdo, selecione Criar um recurso.

Use 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:

• 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.

Depois que o recurso é criado, o portal do Azure mostra que sua implantação 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.

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

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.

CLI do Azure

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

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para 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, consulte Como executar a CLI do Azure em um contêiner 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 entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, 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 entrar, use o comando az account set para selecionar a assinatura na qual 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 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, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

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

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

   Você também pode visualizar 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. Exiba as propriedades do recurso usando o comando az spatial-anchors-account show :

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

   Copie o valor ID da Conta do recurso e o valor do 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-chave em um editor de texto para uso posterior.

   Se você precisar regenerar 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
   

Você pode excluir uma conta usando 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 você optar por usar o Azure PowerShell localmente:
  • Instale a versão mais recente do módulo Az PowerShell.
  • Conecte-se à sua conta do Azure usando o cmdlet Connect-AzAccount .
• Se você optar por usar o Azure Cloud Shell:
  • Consulte Visão geral do Azure Cloud Shell para obter mais informações.

Importante

Enquanto o módulo Az.MixedReality PowerShell estiver em visualização, você deve instalá-lo separadamente usando 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 entrar, use o cmdlet Set-AzContext para selecionar a assinatura na qual 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 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, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

   Você pode exibir suas contas de âncoras espaciais atuais para um grupo de recursos usando o cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Você também pode visualizar 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. Exiba as propriedades do recurso usando o cmdlet Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Copie o valor accountId da propriedade e o valor 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-chave em um editor de texto para uso posterior.

   Se precisar regenerar chaves, use o cmdlet New-AzSpatialAnchorsAccountKey :

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

Você pode excluir uma conta usando o cmdlet Remove-AzSpatialAnchorsAccount :

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

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

Clone Samples Repo

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

Importar ASA SDK

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

Implantar o serviço Âncoras de Compartilhamento

Nota

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

Visual Studio

Abra o Visual Studio e, em seguida, 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 é iniciado.

1. Selecione Target Azure>Next.
2. Selecione Serviço de Aplicativo do Azure de Destino Específico (Windows)>Avançar
3. Inicie sessão no portal do Azure.
4. Selecione o "+" verde para Criar um Serviço de Aplicativo do Azure

Definições do Serviço de Aplicações

Definição	Valor sugerido	Description
Name	myASASharingService	Dê ao seu serviço um nome exclusivo
Nome da Subscrição		Selecione 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, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.
Plano de Alojamento	Selecione Novo... e veja a tabela abaixo	Um plano do serviço de aplicações especifica o local, tamanho e funcionalidades da farm de servidores Web que aloja a aplicação. Você pode economizar dinheiro ao hospedar vários aplicativos configurando os aplicativos Web para compartilhar um único plano do Serviço de Aplicativo. Os planos do Serviço de Aplicativo definem: Região (por exemplo: Europa do Norte, E.U.A. Leste, Ásia Sudeste) Tamanho da instância (pequena, média, grande) Contagem do dimensionamento (1 a 20 instâncias) SKU (Gratuito, Partilhado, Básico, Standard ou Premium)

Configurações do Plano de Hospedagem

Definição	Valor sugerido	Description
Plano de Alojamento	MySharingServicePlan	Dê ao seu plano de hospedagem um nome exclusivo
Localização	E.U.A. Oeste	O centro de dados onde o a aplicação Web está alojada. Escolha um local mais próximo do local físico que seu aplicativo será usado
Tamanho	Gratuito	A camada 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 ASP.NET Core tiver sido publicado no Azure, você poderá acessar https://<your_app_name>.azurewebsites.net ou clicar no link ao lado de Site: na guia SharingService: Publicar. Copie este 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 antes de implantar o serviço no Visual Studio Code.

Iniciar sessão no Azure

Aceda ao portal do Azure e, em seguida, inicie sessão na sua subscrição 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, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

Junto a Grupo de recursos, selecione Novo.

Nomeie o grupo de recursos myResourceGroup e selecione OK.

Criar um plano do Serviço de Aplicações

Um plano do serviço de aplicações especifica o local, tamanho e funcionalidades da farm de servidores Web que aloja a aplicação. Você pode economizar dinheiro ao hospedar vários aplicativos configurando os aplicativos Web para compartilhar um único plano do Serviço de Aplicativo.

Os planos do Serviço de Aplicações definem:

• Região (por exemplo: Europa do Norte, E.U.A. Leste, Ásia Sudeste)
• Tamanho da instância (pequena, média, grande)
• Contagem do dimensionamento (1 a 20 instâncias)
• SKU (Gratuito, Partilhado, Básico, Standard ou Premium)

Junto a Plano de Alojamento, selecione Novo.

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

Definição	Valor sugerido	Description
Plano do Serviço de Aplicações	MySharingServicePlan	Nome do plano do Serviço de Aplicativo
Localização	E.U.A. Oeste	O datacenter onde o aplicativo Web está hospedado
Tamanho	Gratuito	A camada de preço que determina os recursos de hospedagem

Selecione OK.

Abra o Visual Studio Code e, em seguida, 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 o Visual Studio Code. Comece na seção "Abri-lo com o Visual Studio Code". Não crie outro projeto ASP.NET como 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

Em Unity, abra o projeto na pasta Unity . Unity pode perguntar sobre uma diferença entre a versão no projeto e a versão instalada em sua máquina. Este aviso é aceitável, desde que sua versão do Unity Editor seja mais recente do que aquela com a qual o projeto foi criado. Se a sua versão for mais recente, selecione Continuar. Se sua versão for mais antiga do que a que o projeto precisa, selecione Sair e atualize seu Editor Unity.

Configurar configurações de compilação

Abra Configurações de compilação selecionando Configurações de compilação de arquivo>.

Na seção Plataforma, selecione Plataforma Universal do Windows. Altere o dispositivo alvo para HoloLens.

Selecione Mudar de plataforma para alterar a plataforma para a Plataforma Universal do Windows. O Unity pode solicitar que você instale componentes de suporte UWP se eles estiverem faltando.

Feche a janela Configurações de compilação.

Configurar as informações da conta

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

No painel Projeto, vá para Assets\AzureSpatialAnchors.SDK\Resources.

Selecione SpatialAnchorConfig. No painel Inspetor, insira o como o valor para Chave de Conta de Âncoras Espaciais, como o valor para ID de Conta de Âncoras Espaciais e como Account DomainAccount ID o Account Key valor para Domínio de Conta de Âncoras Espaciais.

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

No painel Projeto, vá para Assets\AzureSpatialAnchors.Examples\Resources.

Selecione SpatialAnchorSamplesConfig. Em seguida, no painel Inspetor , insira a Sharing Anchors Service URL (da implantação do Azure do aplicativo Web ASP.NET) como o valor para Base Sharing Url. Anexe o URL com /swagger/api/anchors. Deve ter a seguinte aparência: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Salve a cena selecionando Salvar arquivo>.

Exportar + implantar o aplicativo HoloLens

Abra Configurações de compilação selecionando Configurações de compilação de arquivo>.

Em Cenas na compilação, verifique se todas as cenas têm uma marca de seleção ao lado delas.

Selecione Construir. Na caixa de diálogo, selecione uma pasta na qual exportar o projeto HoloLens Visual Studio.

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

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

Altere a Configuração da Solução para Release, altere a Solution Platform para x86 e selecione Device nas opções de destino de implantação.

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

Ligue o dispositivo HoloLens, inicie sessão e ligue o dispositivo ao PC utilizando um cabo USB.

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

Executar a aplicação

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

Com Create & Share Anchor, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá de volta um identificador para ele que você pode usar para recuperá-lo do serviço de compartilhamento. Em seguida, você pode executar o segundo cenário, Localizar âncora compartilhada, a partir do seu dispositivo ou de um diferente.

Com Localizar âncora compartilhada, você pode localizar âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o seu cenário, a aplicação irá guiá-lo com mais instruções. Por exemplo, ser-lhe-á pedido para mover o dispositivo para recolher informações do ambiente. Mais tarde, você colocará uma âncora no mundo, esperará que ela salve, iniciará uma nova sessão e a localizará.

Unity - Android

Abrir Projeto

Em Unity, abra o projeto na pasta Unity . Unity pode perguntar sobre uma diferença entre a versão no projeto e a versão instalada em sua máquina. Este aviso é aceitável, desde que sua versão do Unity Editor seja mais recente do que aquela com a qual o projeto foi criado. Se a sua versão for mais recente, selecione Continuar. Se sua versão for mais antiga do que a que o projeto precisa, selecione Sair e atualize seu Editor Unity.

Configurar configurações de compilação

Abra Configurações de compilação selecionando Configurações de compilação de arquivo>.

Na secção Plataforma, selecione Android e, em seguida, selecione Mudar de plataforma para alterar a plataforma para Android. Unity pode solicitar que você instale componentes de suporte do Android se eles estiverem faltando.

Feche a janela Configurações de compilação.

Configurar as informações da conta

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

No painel Projeto, vá para Assets\AzureSpatialAnchors.SDK\Resources.

Selecione SpatialAnchorConfig. No painel Inspetor, insira o como o valor para Chave de Conta de Âncoras Espaciais, como o valor para ID de Conta de Âncoras Espaciais e como Account DomainAccount ID o Account Key valor para Domínio de Conta de Âncoras Espaciais.

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

No painel Projeto, vá para Assets\AzureSpatialAnchors.Examples\Resources.

Selecione SpatialAnchorSamplesConfig. Em seguida, no painel Inspetor , insira a Sharing Anchors Service URL (da implantação do Azure do aplicativo Web ASP.NET) como o valor para Base Sharing Url. Anexe o URL com /swagger/api/anchors. Deve ter a seguinte aparência: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Salve a cena selecionando Salvar arquivo>.

Implementar

Inicie sessão no seu dispositivo Android e ligue-o ao computador utilizando um cabo USB.

Abra Configurações de compilação selecionando Configurações de compilação de arquivo>.

Em Cenas na Compilação, verifique se cada cena tem uma marca de seleção ao lado dela.

Certifique-se de que Exportar projeto não tenha uma marca de seleção. Selecione Compilar e executar. Ser-lhe-á pedido para guardar o ficheiro .apk . Você pode escolher qualquer nome para ele.

Executar a aplicação

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

Com Create & Share Anchor, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá de volta um identificador para ele que você pode usar para recuperá-lo do serviço de compartilhamento. Em seguida, você pode executar o segundo cenário, Localizar âncora compartilhada, a partir do seu dispositivo ou de um diferente.

Com Localizar âncora compartilhada, você pode localizar âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o seu cenário, a aplicação irá guiá-lo com mais instruções. Por exemplo, ser-lhe-á pedido para mover o dispositivo para recolher informações do ambiente. Mais tarde, você colocará uma âncora no mundo, esperará que ela salve, iniciará uma nova sessão e a localizará.

Unity - iOS

Abrir Projeto

Em Unity, abra o projeto na pasta Unity . Unity pode perguntar sobre uma diferença entre a versão no projeto e a versão instalada em sua máquina. Este aviso é aceitável, desde que sua versão do Unity Editor seja mais recente do que aquela com a qual o projeto foi criado. Se a sua versão for mais recente, selecione Continuar. Se sua versão for mais antiga do que a que o projeto precisa, selecione Sair e atualize seu Editor Unity.

Configurar configurações de compilação

Abra Configurações de compilação selecionando Configurações de compilação de arquivo>.

Na seção Plataforma, selecione iOS.

Selecione Mudar de plataforma para alterar a plataforma para iOS. Unity pode solicitar que você instale componentes de suporte do iOS se eles estiverem faltando.

Feche a janela Configurações de compilação.

Configurar as informações da conta

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

No painel Projeto, vá para Assets\AzureSpatialAnchors.SDK\Resources.

Selecione SpatialAnchorConfig. No painel Inspetor, insira o como o valor para Chave de Conta de Âncoras Espaciais, como o valor para ID de Conta de Âncoras Espaciais e como Account DomainAccount ID o Account Key valor para Domínio de Conta de Âncoras Espaciais.

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

No painel Projeto, vá para Assets\AzureSpatialAnchors.Examples\Resources.

Selecione SpatialAnchorSamplesConfig. Em seguida, no painel Inspetor , insira a Sharing Anchors Service URL (da implantação do Azure do aplicativo Web ASP.NET) como o valor para Base Sharing Url. Anexe o URL com /swagger/api/anchors. Deve ter a seguinte aparência: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Salve a cena selecionando Salvar arquivo>.

Implantar em um dispositivo iOS

Abra Configurações de compilação selecionando Configurações de compilação de arquivo>.

Em Cenas na Compilação, verifique se cada cena tem uma marca de seleção ao lado dela.

Selecione Construir. No painel que se abre, selecione uma pasta para a qual exportar o projeto Xcode.

Quando a exportação estiver concluída, uma pasta que contém o projeto Xcode exportado será exibida.

Nota

Se aparecer uma janela com uma mensagem perguntando se você deseja substituir ou acrescentar, recomendamos que você selecione Acrescentar, pois é mais rápido. Replace removerá todos os arquivos da pasta de destino e gerará novo conteúdo.

Abra o projeto Xcode

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

Você pode iniciar o Xcode e abrir o projeto exportado Unity-iPhone.xcodeproj ou iniciar o projeto no Xcode executando o seguinte comando do local para onde exportou o projeto:

open ./Unity-iPhone.xcodeproj

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

Em Informações de Implantação, verifique se o destino de implantação está definido como iOS 11.0.

Selecione a guia Assinatura & Recursos e verifique se a opção Gerenciar assinatura automaticamente está habilitada. Se não estiver, ative-o e, em seguida, redefina as configurações de compilação selecionando Ativar automático no painel exibido.

Implantar o aplicativo em seu dispositivo iOS

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

Selecione Compilar e execute o esquema atual.

Executar a aplicação

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

Com Create & Share Anchor, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá de volta um identificador para ele que você pode usar para recuperá-lo do serviço de compartilhamento. Em seguida, você pode executar o segundo cenário, Localizar âncora compartilhada, a partir do seu dispositivo ou de um diferente.

Com Localizar âncora compartilhada, você pode localizar âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o seu cenário, a aplicação irá guiá-lo com mais instruções. Por exemplo, ser-lhe-á pedido para mover o dispositivo para recolher informações do ambiente. Mais tarde, você colocará uma âncora no mundo, esperará que ela salve, iniciará uma nova sessão e a localizará.

No Xcode, pare o aplicativo selecionando Parar.

Android

O exemplo Java Android suporta compartilhamento entre dispositivos.

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

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

Substitua o index.html no URL por api/anchors. Deve ter a seguinte aparência: https://<app_name>.azurewebsites.net/api/anchors.

Implante o aplicativo em seu dispositivo.

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

Siga as instruções no aplicativo. Você pode selecionar Create & Share Anchor ou Locate Shared Anchor.

Com Create & Share Anchor, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá de volta um identificador para ele que você pode usar para recuperá-lo do serviço de compartilhamento. Em seguida, você pode executar o segundo cenário, Localizar âncora compartilhada, a partir do seu dispositivo ou de um diferente.

Com Localizar âncora compartilhada, você pode localizar âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o seu cenário, a aplicação irá guiá-lo com mais instruções. Por exemplo, ser-lhe-á pedido para mover o dispositivo para recolher informações do ambiente. Mais tarde, você colocará uma âncora no mundo, esperará que ela salve, iniciará uma nova sessão e a localizará.

iOS

O exemplo iOS Objective-C suporta compartilhamento entre dispositivos.

Abra o arquivo SharedDemoViewController.m na pasta de exemplos.

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

Substitua o index.html no URL por api/anchors. Deve ter a seguinte aparência: https://<app_name>.azurewebsites.net/api/anchors.

Implante o aplicativo em seu dispositivo.

Depois que o aplicativo for iniciado, selecione a opção Tocar para iniciar a demonstração compartilhada e siga as instruções no aplicativo. Você pode selecionar Tocar para localizar a âncora pelo número da âncora ou Tocar para criar a âncora e salvá-la no serviço.

Com Create & Share Anchor, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá de volta um identificador para ele que você pode usar para recuperá-lo do serviço de compartilhamento. Em seguida, você pode executar o segundo cenário, Localizar âncora compartilhada, a partir do seu dispositivo ou de um diferente.

Com Localizar âncora compartilhada, você pode localizar âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o seu cenário, a aplicação irá guiá-lo com mais instruções. Por exemplo, ser-lhe-á pedido para mover o dispositivo para recolher informações do ambiente. Mais tarde, você colocará uma âncora no mundo, esperará que ela salve, iniciará uma nova sessão e a localizará.

Xamarin

Os exemplos do Xamarin Android e iOS suportam o compartilhamento entre dispositivos.

Abra o arquivo AccountDetails.cs na pasta de exemplos.

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

Substitua o index.html no URL por api/anchors. Deve ter a seguinte aparência: https://<app_name>.azurewebsites.net/api/anchors.

Implante o aplicativo em seu dispositivo.

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

Siga as instruções no aplicativo. Você pode selecionar Create & Share Anchor ou Locate Shared Anchor.

Com Create & Share Anchor, você pode criar uma âncora e salvá-la em seu serviço de compartilhamento. Em troca, você receberá de volta um identificador para ele que você pode usar para recuperá-lo do serviço de compartilhamento. Em seguida, você pode executar o segundo cenário, Localizar âncora compartilhada, a partir do seu dispositivo ou de um diferente.

Com Localizar âncora compartilhada, você pode localizar âncoras compartilhadas anteriormente inserindo o identificador mencionado anteriormente. Depois de escolher o seu cenário, a aplicação irá guiá-lo com mais instruções. Por exemplo, ser-lhe-á pedido para mover o dispositivo para recolher informações do ambiente. Mais tarde, você colocará uma âncora no mundo, esperará que ela salve, iniciará uma nova sessão e a localizará.

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 tutorial, você implantou um aplicativo Web ASP.NET Core no Azure e 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 melhorar seu aplicativo Web ASP.NET Core para que ele use o Azure Cosmos DB para manter o armazenamento de seus 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. Em seguida, usando o identificador de âncora armazenado em seu aplicativo Web, você pode fazer com que o aplicativo retorne dias depois para localizar a âncora novamente.

Usar o Azure Cosmos DB para armazenar âncoras