Execute o aplicativo de exemplo: iOS - Unity (C#)

Este guia de início rápido aborda como executar o aplicativo de exemplo Azure Spatial Anchors para dispositivos iOS usando Unity (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 ARKit iOS construído com Unity que pode salvar e recuperar uma âncora espacial.

Saberá como:

  • Criar uma conta de Âncoras Espaciais
  • Preparar configurações de compilação do Unity
  • Configurar o identificador de conta e a chave de conta das Âncoras Espaciais
  • Exportar o projeto Xcode
  • Implantar e executar em um dispositivo iOS

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 dispositivo iOS compatível com ARKit habilitado para desenvolvedor.
  • Uma máquina macOS com a versão mais recente do Xcode instalada.
  • Uma instalação Unity. Para obter as versões suportadas e os recursos necessários, visite a página de configuração do projeto Unity.
  • Git instalado via HomeBrew. Digite o seguinte comando em uma única linha do Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Em seguida, execute brew install git e brew install git-lfs.

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.

Baixar projeto de exemplo e importar SDK

Repositório de amostras de clone

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

Configurar o Unity

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.

Captura de tela do painel Unity.

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.

Captura de tela da janela Configurações de compilação do Unity.

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 Account Key como o valor para Chave de Conta de Âncoras Espaciais, como Account ID o valor para ID de Conta de Âncoras Espaciais e como Account Domain o valor para Domínio de Conta de Âncoras Espaciais.

Exportar o projeto Xcode

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

Captura de ecrã do botão O meu iPhone para selecionar o dispositivo.

Selecione Compilar e execute o esquema atual.

Captura de ecrã do botão de seta

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

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

Quando terminar, pare o aplicativo pressionando Parar no Xcode.

Resolução de Problemas

Problemas de renderização

Ao executar o aplicativo, se você não vir a câmera como plano de fundo (por exemplo, você verá uma textura em branco, azul ou outras), provavelmente precisará reimportar ativos no Unity. Pare a aplicação. No menu superior do Unity, escolha Ativos -> Reimportar tudo. Em seguida, execute o aplicativo novamente.

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.