Configuración de Azure Spatial Anchors en un proyecto de Unity

En esta guía se muestra cómo empezar a trabajar con el SDK de Azure Spatial Anchors en el proyecto de Unity.

Requisitos de proyecto

Al iniciar un nuevo proyecto de Unity, puede elegir entre la plataforma de complementos Unity XR y el XR integrado heredado.

Plataforma de complementos XR

La plataforma de complementos XR solo se admite en la versión 2.9.0 o posterior del SDK de ASA. Para tener como destino la plataforma de complementos XR, use Unity 2020.3 (LTS) y AR Foundation 4.1.7 con los siguientes paquetes según la plataforma:

• Complemento de OpenXR de Mixed Reality: 1.1.2
• Complemento XR de Windows: 4.5.0
• Complemento XR de ARCore: 4.1.7
• Complemento XR de ARKit: 4.1.7

XR integrado heredado

XR integrado heredado solo se admite en la versión 2.8.1 o anterior del SDK de ASA. Para tener como destino el complemento XR integrado heredado, use Unity 2019.4 (LTS) y AR Foundation 3.1.3 con los siguientes paquetes según la plataforma:

• Windows Mixed Reality: 4.2.1
• Complemento XR de ARCore: 3.1.3
• Complemento XR de ARKit: 3.1.3

Configuración de un proyecto

Antes de incluir el SDK de Azure Spatial Anchors en el proyecto de Unity, asegúrese de instalar los paquetes necesarios mediante el administrador de paquetes de Unity.

Elección de la versión de ASA

Para determinar qué versión del SDK de ASA se va a usar en el proyecto de Unity, seleccione la versión de Unity a continuación.

Unity 2020

Se ha agregado compatibilidad para Unity 2020 con el SDK 2.9.0 de ASA. Se recomienda usar el SDK de ASA más reciente para el desarrollo de Unity 2020.

Importante

Si usa el complemento OpenXR de Mixed Reality, la versión mínima compatible es el SDK 2.10.0 de ASA. Si usa Windows XR 4.5.1 o posterior, el SDK 2.11.0 de ASA es la versión mínima admitida.

Unity 2019

La versión mínima admitida en Unity 2019 es el SDK 2.7.0 de ASA. La versión más reciente que proporciona compatibilidad con Unity 2019 es el SDK 2.8.1 de ASA.

Descarga de paquetes de ASA

El siguiente paso es descargar los paquetes de Azure Spatial Anchors para Unity.

Para usar Azure Spatial Anchors en Unity, debe descargar tantoel paquete principal (com.microsoft.azure.spatial-anchors-sdk.core) como un paquete específico de plataforma para cada plataforma que tenga previsto admitir.

Plataforma	Nombres de paquete necesarios
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>

Herramienta de características de Mixed Reality

Nota:

Actualmente, la herramienta de características de Mixed Reality solo es compatible con Windows.

Continúe con el paso siguiente. Usará la herramienta de características de Mixed Reality en un paso posterior.

Descarga con explorador web

Busque aquí el paquete principal (com.microsoft.azure.spatial-anchors-sdk.core) de Azure Spatial Anchors para Unity. Seleccione la versión que desee y descargue el paquete con el botón Download (Descargar). Repita este paso a fin de descargar el paquete para cada plataforma que tenga previsto admitir.

Descarga con NPM

En los pasos siguientes se supone que NPM está instalado y disponible.

Ejecute el siguiente comando reemplazando <version_number> por la versión de Azure Spatial Anchors que desea descargar en la carpeta actual:

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 enumerar las versiones disponibles del paquete de Azure Spatial Anchors, ejecute lo siguiente:

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

El paquete principal de Azure Spatial Anchors se descargará en la carpeta donde se ejecutó el comando. Repita este paso a fin de descargar el paquete para cada plataforma que tenga previsto admitir.

Importación de paquetes de ASA

Herramienta de características de Mixed Reality

Este paso requiere que la herramienta de características de Mixed Reality esté descargada y disponible.

1. Consulte la documentación de la herramienta de características de Mixed Reality para configurar la herramienta y aprender a usarla.
2. Instalación de
   1. SDK Core de Azure Spatial Anchors
   2. SDK de Azure Spatial Anchors para <sus plataformas>
   3. Mixed Reality con complemento OpenXR si usa OpenXR, ubicado en Compatibilidad con plataformas

Descarga con explorador web

Siga las instrucciones incluidas aquí para importar los paquetes de Azure Spatial Anchors que descargó en el proyecto de Unity mediante el administrador de paquetes de Unity.

Descarga con NPM

Siga las instrucciones incluidas aquí para importar los paquetes de Azure Spatial Anchors que descargó en el proyecto de Unity mediante el administrador de paquetes de Unity.

Configuraciones adicionales

Si va a desarrollar para HoloLens o Android, siga los pasos de configuración adicionales que se indican a continuación.

HoloLens

Configuración de XR del proyecto de Unity

Al desarrollar aplicaciones de Mixed Reality en HoloLens, debe establecer la configuración de XR en Unity. Para más información, vea Establecimiento de la configuración de XR - Mixed Reality | Microsoft Docs y Elección de una versión de Unity y un complemento XR - Mixed Reality | Microsoft Docs.

La versiones 2.9.0 o anteriores del SDK de Azure Spatial Anchors solo proporcionan compatibilidad para el complemento XR de Windows (com.unity.xr.windowsmr) y, por lo tanto, el paquete de Windows de Azure Spatial Anchor tiene una dependencia explícita del complemento XR de Windows.

Las versiones 2.10.0 o posteriores del SDK de Azure Spatial Anchors admiten tanto el complemento OpenXR de Mixed Reality (com.microsoft.mixedreality.openxr) como el complemento XR de Windows com.unity.xr.windowsmr. Debe incluir el paquete com.microsoft.mixedreality.openxr o el paquete com.unity.xr.windowsmr en el proyecto en función de su elección.

Configuración de las funcionalidades del proyecto de Unity

Asegúrese de habilitar las siguientes funcionalidades en el proyecto de Unity:

• SpatialPerception
• InternetClient
• PrivateNetworkClientServer

Advertencia

Si no se habilita la funcionalidad PrivateNetworkClientServer, se puede producir un error al consultar los delimitadores cuando el dispositivo usa una red que está configurada para ser privada.

Android

configuración del archivo mainTemplate.gradle

1. Vaya a Edit>Project Settings>Player (Editar > Configuración del proyecto > Reproductor).

2. En Inspector Panel (Panel de inspector) de Player Settings (Configuración del Reproductor), seleccione el icono de Android.

3. En la sección Build, active la casilla Custom Main Gradle Template (Plantilla principal de Gradle personalizada) para generar una plantilla personalizada de Gradle en Assets\Plugins\Android\mainTemplate.gradle.

4. Abre el archivo mainTemplate.gradle en un editor de texto.

5. En la sección dependencies, pegue las siguientes dependencias:

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

Cuando haya terminado, la sección dependencies debe tener un aspecto similar al siguiente:

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**}

Pasos siguientes

Cómo: Crear y localizar anclajes en Unity