Como configurar as Âncoras Espaciais do Azure em um projeto do Unity

O Framework do XR Plug-in só tem suporte no SDK do ASA versão 2.9.0 ou posterior. Para direcionar o Framework do XR Plug-in, use o Unity 2020.3 (LTS) e o RA Foundation 4.1.7 com os seguintes pacotes, dependendo da sua plataforma:

• Plug-in OpenXR de Realidade Misturada: 1.1.2
• Plug-in do Windows XR: 4.5.0
• Plug-in do ARCore XR: 4.1.7
• Plug-in do ARKit XR: 4.1.7

O XR integrado herdado só tem suporte no SDK do ASA versão 2.8.1 ou anterior. Para direcionar o XR integrado herdado, use o Unity 2019.4 (LTS) e o RA Foundation 3.1.3 com os seguintes pacotes, dependendo da sua plataforma:

• Realidade Misturada do Windows: 4.2.1
• Plug-in do ARCore XR: 3.1.3
• Plug-in do ARKit XR: 3.1.3

O suporte ao Unity 2020 foi adicionado com o SDK do ASA 2.9.0. Sugerimos usar o SDK do ASA mais recente para desenvolvimento no Unity 2020.

A versão mínima com suporte no Unity 2019 é o SDK do ASA 2.7.0. A versão mais recente que dá suporte ao Unity 2019 é o SDK do ASA 2.8.1.

Siga para a próxima etapa. Você usará a Ferramenta de Recurso de Realidade Misturada em uma etapa posterior.

Localize o pacote principal das Âncoras Espaciais do Azure (com.microsoft.azure.spatial-anchors-sdk.core) para o Unity aqui. Selecione a versão desejada e baixe o pacote usando o botão Baixar. Repita essa etapa para baixar o pacote para cada plataforma para a qual você planeja dar suporte.

As etapas a seguir pressupõem que o NPM está instalado e disponível.

Execute o seguinte comando substituindo <version_number> pela versão das Âncoras Espaciais do Azure que você deseja baixar na pasta atual:

npm pack com.microsoft.azure.spatial-anchors-sdk.core@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

npm view com.microsoft.azure.spatial-anchors-sdk.core --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

O pacote principal das Âncoras Espaciais do Azure será baixado para a pasta em que você executou o comando. Repita essa etapa para baixar o pacote para cada plataforma para a qual você planeja dar suporte.

Essa etapa requer que a Ferramenta de Recurso de Realidade Misturada esteja baixada e disponível.

1. Consulte a documentação da Ferramenta de Recurso de Realidade Misturada para configurá-la e aprender a usá-la.
2. Instalar o
   1. SDK de Âncoras Espaciais do Azure – núcleo
   2. SDK de Âncoras Espaciais do Azure para <plataformas>
   3. Plug-in OpenXR de Realidade Misturada se usar OpenXR – localizado em Suporte da Plataforma

Siga as instruções aqui para importar os pacotes das Âncoras Espaciais do Azure que você baixou para o projeto do Unity usando o Gerenciador de Pacotes do Unity.

Siga as instruções aqui para importar os pacotes das Âncoras Espaciais do Azure que você baixou para o projeto do Unity usando o Gerenciador de Pacotes do Unity.

Definir as configurações do XR do projeto do Unity

Ao desenvolver aplicativos MixedReality no HoloLens, você precisa definir a configuração XR no Unity. Consulte Definir a configuração de XR - Realidade Misturada | Microsoft Docs e Escolher uma versão do Unity e um plug-in XR - Realidade Misturada | Microsoft Docs para obter mais detalhes.

As versões 2.9.0 ou anteriores do SDK das Âncoras Espaciais do Azure dão suporte apenas para o plug-in XR do Windows (com.unity.xr.windowsmr) e, portanto, o pacote do Windows das Âncoras Espaciais do Azure tem uma dependência explícita no plug-in XR do Windows.

O SDK de Âncoras Espaciais do Azure versão 2.10.0 ou posterior dá suporte ao plug-in OpenXR de Realidade Misturada (com.microsoft.mixedreality.openxr) e ao plug-in XR do Windows com.unity.xr.windowsmr. Você precisa incluir o pacote com.microsoft.mixedreality.openxr ou o pacote com.unity.xr.windowsmr no projeto, dependendo da sua escolha.

Configurar seus recursos de projeto do Unity

Garanta que os seguintes recursos sejam habilitados no projeto do Unity:

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Configurar o arquivo mainTemplate.gradle

1. Vá para Editar>Configurações do Projeto>Player.

2. No Painel do Inspetor em Configurações do Player, selecione o ícone do Android.

3. Na seção Criar, marque a caixa de seleção Modelo do Gradle Principal Personalizado para gerar um modelo do Gradle personalizado em Assets\Plugins\Android\mainTemplate.gradle.

4. Abra o arquivo mainTemplate.gradle em um editor de texto.

5. Na seção dependencies, cole as seguintes dependências:

   implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
   implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
   

Quando tudo estiver concluído, a seção dependencies terá uma aparência semelhante a esta:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation('com.squareup.okhttp3:okhttp:[3.11.0]')
    implementation('com.microsoft.appcenter:appcenter-analytics:[1.10.0]')
**DEPS**}

Próximas etapas