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

Artigo
10/26/2023

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

Saberá como:

Crie uma conta de Âncoras Espaciais.
Prepare as configurações de compilação do Unity.
Configure o identificador de conta e a chave de conta das Âncoras Espaciais.
Exporte o projeto HoloLens Visual Studio.
Implante o aplicativo e execute-o em um dispositivo HoloLens.

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

Pré-requisitos

Para concluir este guia de início rápido:

Você precisa de um dispositivo HoloLens com o modo de desenvolvedor ativado. Para o HoloLens 2, a atualização de maio de 2020 do Windows 10 ou posterior deve estar instalada no dispositivo. Para atualizar para a versão mais recente no HoloLens, abra o aplicativo Configurações , vá para Atualizar & Segurança e selecione Verificar se há atualizações.
Você precisa de um computador Windows com o Visual Studio 2019 ou posterior instalado. Sua instalação do Visual Studio deve incluir a carga de trabalho de desenvolvimento da Plataforma Universal do Windows e o componente SDK do Windows 10 (10.0.18362.0 ou mais recente). Você também deve instalar o Git para Windows e o Git LFS.
Você precisa ter o Unity instalado. Para obter as versões suportadas e os recursos necessários, visite a página de configuração do projeto Unity.

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.

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.

Screenshot of the Spatial Anchors pane for creating a resource.

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

Screenshot showing that the resource deployment is complete.

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.

Screenshot of the resource properties pane.

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

Screenshot showing the resource's account domain value.

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.

Screenshot of the Keys pane for the account.

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.

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

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

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.

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

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

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

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

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

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.

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

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

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.

Screenshot of the Unity pane.

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.

Screenshot of the Unity Build Settings pane - HoloLens

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.

Exportar o projeto HoloLens Visual Studio

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

Implantar o aplicativo HoloLens

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.

Visual Studio configuration

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

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.

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4

No Visual Studio, pare o aplicativo selecionando Parar Depuração ou Shift+F5.

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.

Tutorial: Compartilhar âncoras espaciais entre dispositivos

Como: Configurar âncoras espaciais do Azure em um projeto Unity