Configurando âncoras espaciais do Azure em um projeto Unity

Artigo
10/26/2023

Este guia mostrará como começar a usar o SDK do Azure Spatial Anchors em seu projeto Unity.

Requisitos do projeto

Ao iniciar um novo projeto Unity, você pode escolher entre o Unity XR Plug-in Framework e o Legacy Built-in XR.

Estrutura de plug-in XR
XR integrado legado

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

Configurando um projeto

Antes de incluir o SDK do Azure Spatial Anchors em seu projeto Unity, certifique-se de instalar os pacotes necessários por meio do Gerenciador de Pacotes Unity.

Escolha a versão ASA

Para determinar qual versão do ASA SDK usar em seu projeto Unity, selecione sua versão do Unity abaixo.

Unidade 2020
Unidade 2019

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.

Importante

Se estiver usando o plug-in OpenXR de realidade mista, o ASA SDK 2.10.0 é a versão mínima suportada. Se estiver usando o Windows XR 4.5.1 ou posterior, o ASA SDK 2.11.0 é a versão mínima suportada.

Baixar pacotes ASA

A próxima etapa é baixar os pacotes do Azure Spatial Anchors para Unity.

Para usar as Âncoras Espaciais do Azure no Unity, você precisa baixar o pacote principal (com.microsoft.azure.spatial-anchors-sdk.core) e um pacote específico da plataforma para cada plataforma que você planeja suportar.

Plataforma	Nomes de pacotes necessários
HoloLens	`com.microsoft.azure.spatial-anchors-sdk.core@<version_number>` `com.microsoft.azure.spatial-anchors-sdk.windows@<version_number>`
Android	`com.microsoft.azure.spatial-anchors-sdk.core@<version_number>` `com.microsoft.azure.spatial-anchors-sdk.android@<version_number>`
iOS	`com.microsoft.azure.spatial-anchors-sdk.core@<version_number>` `com.microsoft.azure.spatial-anchors-sdk.ios@<version_number>`

Nota

Atualmente, a Mixed Reality Feature Tool suporta apenas o Windows.

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

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/

Nota

Para listar as versões disponíveis do pacote Azure Spatial Anchors, execute o seguinte:

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.

Importar pacotes ASA

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

Siga a documentação da Mixed Reality Feature Tool para configurar a ferramenta e aprender a usá-la.
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

Configurações extras

Se você estiver desenvolvendo para HoloLens ou Android, siga as etapas de configuração adicionais abaixo

HoloLens
Android

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

Aviso

A falha ao habilitar o recurso PrivateNetworkClientServer pode levar a uma falha na consulta de âncoras quando o dispositivo estiver usando uma rede configurada para ser privada.

Configurar o arquivo mainTemplate.gradle

Vá para Editar>configurações do>projeto Player.
No Painel do Inspetor para Configurações do Player, selecione o ícone do Android.
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.
Abra o mainTemplate.gradle ficheiro num editor de texto.

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

Como: Criar e localizar âncoras no Unity

Share via