Configurando âncoras espaciais do Azure em um projeto Unity

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

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

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

• Realidade mista do Windows: 4.2.1
• ARCore XR Plugin: 3.1.3
• ARKit XR Plugin: 3.1.3

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

A versão mínima suportada no Unity 2019 é o ASA SDK 2.7.0. A versão mais recente que fornece suporte para Unity 2019 é ASA SDK 2.8.1.

Continue para a próxima etapa. Você usará a Ferramenta de Recursos de Realidade Mista em uma etapa posterior.

Localize o pacote principal do Azure Spatial Anchors (com.microsoft.azure.spatial-anchors-sdk.core) para Unity aqui. Selecione a versão desejada e baixe o pacote usando o botão Download . Repita esta etapa para baixar o pacote para cada plataforma que você planeja suportar.

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

Execute o seguinte comando substituindo <version_number> pela versão das Âncoras Espaciais do Azure que você deseja baixar para a 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 do Azure Spatial Anchors será baixado para a pasta onde você executou o comando. Repita esta etapa para baixar o pacote para cada plataforma que você planeja suportar.

Esta etapa requer que a Ferramenta de Recursos de Realidade Mista seja baixada e esteja disponível.

1. Siga a documentação da Mixed Reality Feature Tool para configurar a ferramenta e aprender a usá-la.
2. Instalar
   1. Azure Spatial Anchors SDK Core
   2. SDK do Azure Spatial Anchors para <sua(s) plataforma(s)>
   3. Mixed Reality OpenXR Plugin se estiver usando OpenXR - localizado em Suporte à plataforma

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

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

Definir as configurações XR do seu projeto Unity

Ao desenvolver aplicativos de Realidade Mista no HoloLens, você precisa definir a configuração XR no Unity. Para obter mais informações, consulte Configurando sua configuração XR - Mixed Reality | Microsoft Docs e escolhendo uma versão Unity e plugin XR - Realidade mista | Documentos Microsoft.

As versões 2.9.0 ou anteriores do SDK do Azure Spatial Anchors fornecem suporte apenas para o plug-in do Windows XR (com.unity.xr.windowsmr), portanto, o pacote do Windows Azure Spatial Anchors tem uma dependência explícita do plug-in do Windows XR.

As versões 2.10.0 ou posteriores do SDK do Azure Spatial Anchors fornecem suporte para o plug-in OpenXR de Realidade Mista (com.microsoft.mixedreality.openxr) e o plug-in com.unity.xr.windowsmrdo Windows XR. Você precisa incluir o com.microsoft.mixedreality.openxr pacote ou o pacote em seu projeto, dependendo de com.unity.xr.windowsmr sua escolha.

Configure os recursos do seu projeto Unity

Certifique-se de ativar os seguintes recursos em seu projeto Unity:

• Perceção Espacial
• InternetClient
• PrivateNetworkClientServer

Configurar o arquivo mainTemplate.gradle

1. Vá para Editar>configurações do>projeto Player.

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

3. Na seção Build, marque a caixa de seleção Custom Main Gradle Template para gerar um modelo de gradle personalizado em Assets\Plugins\Android\mainTemplate.gradle.

4. Abra o mainTemplate.gradle ficheiro num editor de texto.

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

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

Quando estiver tudo pronto, sua dependencies seção deverá ter esta aparência:

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óximos passos