Inicio rápido: Creación de una aplicación HoloLens en Unity que use Azure Spatial Anchors
En este inicio rápido se creará una aplicación HoloLens en Unity con Azure Spatial Anchors. Spatial Anchors es un servicio multiplataforma para desarrolladores que permite crear experiencias de realidad mixta con objetos cuya ubicación persiste en todos los dispositivos a lo largo del tiempo. Cuando haya terminado, tendrá una aplicación HoloLens compilada con Unity que puede guardar y recuperar un delimitador espacial.
Aprenderá a:
- Crear una cuenta de Spatial Anchors.
- Preparar la configuración de compilación de Unity.
- Configurar la clave y el identificador de la cuenta de Spatial Anchors.
- Exportar el proyecto HoloLens de Visual Studio.
- Implementar la aplicación y ejecutarla en un dispositivo HoloLens.
Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
Prerrequisitos
Para completar esta guía de inicio rápido:
- Necesita un equipo Windows que tenga instalados Unity (LTS) y Visual Studio 2019, o cualquier versión posterior. Use Unity 2020 LTS con la versión 2.9 del SDK de ASA, o cualquier versión posterior (que usa el complemento Unity XR Plug-in Framework), o Unity 2019 LTS con la versión 2.8 del SDK de ASA, o cualquier versión anterior. La instalación de Visual Studio debe incluir la carga de trabajo de desarrollo de la Plataforma universal de Windows y el componente SDK de Windows 10 (10.0.18362.0 o posterior) . También se debe instalar Git para Windows y Git LFS.
- Se necesita un dispositivo HoloLens en el que esté habilitado el modo de desarrollador. La actualización de Windows 10 de mayo de 2020 se debe instalar en el dispositivo. Para actualizar a la versión más reciente en HoloLens, abra la aplicación Settings (Configuración), vaya a Update & Security (Actualización y seguridad) y seleccione Check for updates (Buscar actualizaciones).
- En la aplicación, debe habilitar la funcionalidad SpatialPerception. Este valor está en Build Settings > Player Settings > Publishing Settings > Capabilities (Configuración de compilación > Configuración del reproductor > Configuración de publicación > Funcionalidades).
- En la aplicación, es preciso habilitar Virtual Reality Supported (Admite realidad virtual) con el SDK de Windows Mixed Reality. Este valor está en Build Settings > Player Settings > XR Settings (Configuración de compilación > Configuración del reproductor > Configuración de XR).
Creación de un recurso de Spatial Anchors
Vaya a Azure Portal.
En el menú izquierdo, seleccione Crear un recurso.
Use el cuadro de búsqueda para buscar Spatial Anchors.
Seleccione Spatial Anchors y, después, seleccione Crear.
En el panel Cuenta de Spatial Anchors, haga lo siguiente:
Escriba un nombre de recurso único con caracteres alfanuméricos normales.
Seleccione la suscripción a la que desea asociar el recurso.
Cree un grupo de recursos, para lo que debe seleccionar Crear nuevo. Asígnele el nombre myResourceGroup y luego seleccione Aceptar.
Un grupo de recursos es un contenedor lógico en el que los recursos de Azure, como aplicaciones web, bases de datos y cuentas de almacenamiento, se implementen y administren. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.
Seleccione la ubicación (región) en la que desea colocar el recurso.
Seleccione Crear para empezar a crear el recurso.
Una vez creado el recurso, Azure Portal muestra que se ha completado la implementación.
Haga clic en Go to resource (Ir al recurso). Ahora puede ver las propiedades del recurso.
Copie el valor de Id. de cuenta del recurso en un editor de texto para usarlo más adelante.
Copie también el valor de Account Domain (Dominio de cuenta) del recurso en un editor de texto para usarlo más adelante.
En Configuración, seleccione Clave de acceso. Copie el valor de Clave principal, Clave de cuenta, en un editor de texto para su uso posterior.
Descarga y apertura del proyecto de Unity de ejemplo
Ejecute los siguientes comandos para clonar el repositorio de ejemplos:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Siga las instrucciones que se proporcionan aquí para descargar e importar los paquetes del SDK de ASA necesarios para la plataforma HoloLens.
En Unity, abra el proyecto en la carpeta de Unity. Unity podría notificarle sobre una diferencia entre la versión del proyecto y la que tiene instalada en la máquina. Esta advertencia es correcta, siempre que su versión del Editor de Unity sea más reciente que con la que se creó el proyecto. Si la versión es más reciente, seleccione Continuar. Si la versión es anterior a la que necesita el proyecto, Seleccione Salir y actualice el Editor de Unity.
Seleccione File > Build Settings (Archivo > Configuración de compilación) para abrir Build Settings (Configuración de compilación).
En la sección Platform (Plataforma), seleccione Universal Windows Platform (Plataforma universal de Windows). Cambie el valor de Target Device (Dispositivo de destino) a HoloLens.
Seleccione Switch Platform (Cambiar plataforma) para cambiar la plataforma a Universal Windows Platform (Plataforma universal de Windows). Unity puede solicitarle que instale los componentes de compatibilidad con Plataforma universal de Windows si no están presentes.
Cierre la ventana Build Settings (Configuración de compilación).
Configuración de la información de una cuenta
El paso siguiente es configurar la aplicación para que use la información de su cuenta. Ha copiado los valores de Clave de cuenta, Id. de cuenta y Account Domain (Dominio de cuenta) en un editor de texto, en la sección "Creación de un recurso de Spatial Anchors".
En el panel Proyecto, vaya a Assets\AzureSpatialAnchors.SDK\Resources.
Seleccione SpatialAnchorConfig. En el panel Inspector, especifique Account Key como el valor de la clave de cuenta de Spatial Anchors, Account ID como el valor del id. de cuenta de Spatial Anchors y Account Domain como el valor del dominio de cuenta de Spatial Anchors.
Exportar el proyecto de HoloLens de Visual Studio
Seleccione File > Build Settings (Archivo > Configuración de compilación) para abrir Build Settings (Configuración de compilación).
En Scenes In Build (Escenas en compilación), asegúrese de que haya una marca de verificación junto a cada escena.
Seleccione Build (Compilar). En el cuadro de diálogo, seleccione la carpeta en la que se va a exportar el proyecto HoloLens de Visual Studio.
Cuando se complete la exportación, aparecerá una carpeta que contiene el proyecto HoloLens exportado.
Implementación de la aplicación HoloLens
En la carpeta, haga doble clic en HelloAR U3D.sln para abrir el proyecto en Visual Studio.
Cambie el valor de Configuración de solución a Versión, cambie el de Plataforma de solución a x86 y seleccione Dispositivo en las opciones de destino de implementación.
Si usa HoloLens 2, utilice ARM64 como Plataforma de soluciones, en lugar de x86.
Encienda el dispositivo HoloLens, inicie sesión y conéctelo al equipo mediante un cable USB.
Seleccione Depurar > Iniciar depuración para implementar la aplicación y comenzar la depuración.
En la aplicación, seleccione BasicDemo mediante las flechas y pulse el botón Go! para ejecutar la demostración. Siga las instrucciones para colocar y recuperar un delimitador.
En Visual Studio, seleccione Detener depuración o presione Mayús + F5 para detener la depuración.
Limpieza de recursos
En los pasos anteriores, creó recursos de Azure en un grupo de recursos. Si no cree que vaya a necesitar estos recursos en el futuro, puede eliminarlos mediante la eliminación del grupo de recursos.
En el menú de Azure Portal o la página Inicio, seleccione Grupos de recursos. En la página Grupos de recursos, seleccione myResourceGroup.
En la página myResourceGroup, asegúrese de que los recursos enumerados sean los que desea eliminar.
Seleccione Eliminar grupo de recursos, escriba myResourceGroup en el cuadro de texto para confirmar y, después, seleccione Eliminar.
Pasos siguientes
En este inicio rápido, ha creado una cuenta de Spatial Anchors. Después, ha configurado e implementado una aplicación para guardar y recuperar los anclajes espaciales. Para más información acerca de cómo mejorar la aplicación para que pueda compartir anclajes espaciales con otros dispositivos, diríjase al siguiente tutorial.