Compartir a través de


Ejecución de la aplicación de ejemplo: iOS y Unity (C#)

En este inicio rápido, se explica cómo ejecutar la aplicación de ejemplo de Azure Spatial Anchors para dispositivos iOS mediante Unity (C#). Azure Spatial Anchors es un servicio multiplataforma para desarrolladores que le permite crear experiencias de realidad mixta mediante objetos cuya ubicación persiste en todos los dispositivos a lo largo del tiempo. Cuando haya terminado, tendrá una aplicación iOS de ARKit 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
  • Exportación del proyecto de Xcode
  • Implementarlo y ejecutarlo en un dispositivo iOS

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Prerrequisitos

Para completar esta guía de inicio rápido, asegúrese de que dispone de lo siguiente:

  • Un dispositivo iOS compatible con ARKit habilitado para el desarrollo.
  • Una máquina macOS con la versión más reciente de Xcode instalada.
  • Una instalación de Unity. Para obtener las versiones admitidas y las funcionalidades necesarias, visite la página de instalación del proyecto Unity.
  • GIT instalado mediante HomeBrew. Escriba el siguiente comando en una sola línea de Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Luego, ejecute brew install git y brew install git-lfs.

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.

Captura de pantalla que muestra los resultados de una búsqueda de 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.

Captura de pantalla del panel Spatial Anchors para crear un recurso.

Una vez creado el recurso, Azure Portal muestra que se ha completado la implementación.

Captura de pantalla que muestra que la implementación del recurso se ha completado.

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.

Captura de pantalla del panel de propiedades de recursos.

Copie también el valor de Account Domain (Dominio de cuenta) del recurso en un editor de texto para usarlo más adelante.

Captura de pantalla que muestra el valor del dominio de la cuenta del recurso.

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.

Captura de pantalla del panel de claves de la cuenta.

Descarga del proyecto de ejemplo e importación del SDK

Clonación del repositorio de ejemplos

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

Importación del SDK de ASA

Siga las instrucciones que se proporcionan aquí para descargar e importar los paquetes del SDK de ASA necesarios para la plataforma iOS.

Configuración de Unity

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.

Captura de pantalla del panel 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 iOS.

Seleccione Switch Platform (Cambiar plataforma) para cambiar la plataforma a iOS. Unity puede solicitarle que instale los componentes de compatibilidad con iOS si no están presentes.

Captura de pantalla de la ventana de configuración de compilación de Unity.

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.

Exportación del proyecto de Xcode

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 panel que se abre, seleccione la carpeta a la que va a exportar el proyecto Xcode.

Cuando se completa la exportación, aparece una carpeta que contiene el proyecto Xcode exportado.

Nota

Si aparece una ventana con un mensaje en el que se pregunta si quiere reemplazar o anexar, es aconsejable que seleccione Append (Anexar), porque es más rápido. Reemplazar quitará todos los archivos de la carpeta de destino y generará nuevo contenido.

Apertura del proyecto de Xcode

Puede abrir el proyecto Unity-iPhone.xcodeproj en Xcode.

Puede iniciar Xcode y abrir el proyecto Unity-iPhone.xcodeproj exportado, o bien iniciar el proyecto en Xcode mediante la ejecución del siguiente comando desde la ubicación en la que exportó el proyecto:

open ./Unity-iPhone.xcodeproj

Seleccione el nodo raíz Unity-iPhone para ver la configuración del proyecto y, después, seleccione la pestaña General.

En Deployment Info (Información de implementación), asegúrese de que el destino de implementación está establecido en iOS 11.0.

Seleccione la pestaña Signing & Capabilities (Firma y funcionalidades) y asegúrese de que la opción Automatically manage signing (Administrar automáticamente la firma) está habilitada. Si no lo está, habilítelo y luego restablezca la configuración de la compilación seleccionando Enable Automatic (Habilitar automático) en el panel que aparece.

Implementación de la aplicación en el dispositivo iOS

Conecte el dispositivo iOS al equipo Mac y establezca el esquema activo en su dispositivo iOS.

Captura de pantalla del botón Mi iPhone para seleccionar el dispositivo.

Seleccione Build and then run the current scheme (Compilar y luego ejecutar el esquema actual).

Captura de pantalla del botón de flecha para la

En la aplicación, seleccione BasicDemo mediante las flechas y después pulse el botón Go! (Ir) para ejecutar la demostración. Siga las instrucciones para colocar y recuperar un delimitador.

Captura de pantalla 1Captura de pantalla 2Captura de pantalla 3

Cuando termine, presione Stop (Detener) en Xcode para detener la aplicación.

Solución de problemas

Problemas de representación

Cuando se ejecuta la aplicación, si no ve la cámara como fondo (en cambio ve, por ejemplo, una textura negra, azul o de otro tipo), es probable que deba volver a importar los recursos en Unity. Detenga la aplicación. En el menú superior de Unity, elija Assets -> Re-import all (Recursos -> Volver a importar todo). Luego, vuelva a ejecutar la aplicació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.