Comienza a usar el Creador de Geospatial para Unity

1. Antes de comenzar

El Creador de Geospatial, con la tecnología de ARCore y Google Maps Platform, te permite crear experiencias de realidad aumentada (RA) en el editor de Unity. Usa la API de Photorealistic 3D Tiles de Google para generar una vista previa de la experiencia en el mundo real sin necesidad de visitar físicamente esa ubicación.

En este codelab, comenzarás a usar el Creador de Geospatial. Además, recibirás instrucciones para configurar rápidamente el proyecto de Unity y aprenderás a usar el editor. Después, importarás un recurso a la escena y lo colocarás en la réplica digital del mundo real. También agregarás una animación al recurso para darle vida. Por último, visualizarás el contenido en tu dispositivo en RA.

Requisitos previos

• Conocimientos básicos de RA

Qué aprenderás

• Cómo configurar el proyecto del Creador de Geospatial de ARCore en Unity
• Cómo navegar por la vista Scene
• Cómo colocar un recurso 3D en la vista Scene
• Cómo agregar un comportamiento simple al recurso
• Cómo ejecutar la experiencia de RA en tu dispositivo

Requisitos

• Instalar Unity Hub
• Tener un dispositivo Android o iOS compatible configurado para el desarrollo de apps
• En el caso de los dispositivos de destino Android, tener instalado y configurado Android Studio para compilar apps para Android, y tener instalado Servicios de Google Play para RA en el dispositivo de desarrollo Android
• Para dispositivos de destino iOS, tener Xcode

2. Configura tu entorno de desarrollo

Para recuperar datos de Photorealistic 3D Tiles de Google Cloud, debes configurar la autorización.

Configura un proyecto de Google Cloud

1. Crea un proyecto en la consola de Google Cloud.
2. En el cuadro de texto Nombre del proyecto, escribe un nombre apropiado como ARCore Geospatial API project y, luego, elige una ubicación.
3. Haz clic en Crear.
4. En la consola de Google Cloud, en la página del selector de proyectos, haz clic en Crear proyecto.

Habilita la API de 3D Tiles

Para habilitar la API de 3D Tiles, haz clic en el siguiente botón y, luego, selecciona Habilitar:

Habilitar la API de 3D Tiles

Habilita la API de ARCore

Para habilitar la API de ARCore, haz clic en el siguiente botón y, luego, selecciona Habilitar:

Habilitar la API de ARCore

Crea una clave de API para tu proyecto

1. En la consola de Google Cloud, en APIs y servicios, selecciona Credenciales.
2. En la parte superior de la página, haz clic en Crear credenciales y, luego, selecciona Clave de API.
3. Anota la clave porque la necesitarás en los próximos pasos.

Configura el software

Para comenzar a usar el editor de Geospatial, sigue estos pasos:

1. En Unity Hub, crea un proyecto 3D. La versión de Unity debe ser la 2021.3.17f1 o posterior.
2. Haz clic en Window > Package Manager y, luego, sigue estos pasos para agregar los paquetes necesarios:
   1. Haz clic en + > Add package from git URL > https://github.com/google-ar/arcore-unity-extensions.git.
   2. Haz clic en Samples y, luego, importa la muestra geoespacial.
   3. file_downloadDescarga la versión más reciente de Cesium for Unity y, luego, haz clic en + > Add package from tarball > com.cesium.unity-1.0.0.tgz.
3. Si todavía no se ha instalado Shader Graph, sigue estos pasos para hacerlo:
   1. Haz clic en In Project > Unity Registry.
   2. Instala Shader Graph.

Configura la escena de muestra con objetos de ARCore

1. En el panel Project, haz clic en Assets > Samples > ARCore Extensions > 1.37.0 > Geospatial Sample > Scenes > Geospatial.
2. Haz clic en Layers y, luego, inhabilita la capa de la IU.
3. Haz clic en Edit > Project Settings > XR Plug-in Management > ARCore Extensions.
4. Configura una estrategia de autorización de clave de API para tu plataforma de destino.
5. Habilita las funciones opcionales Geospatial y Geospatial Creator.
6. En el panel Hierarchy, haz clic en + > XR > Geospatial Creator Origin.
7. En el panel Hierarchy, selecciona AR Geospatial Creator Origin.
8. En el panel Inspector, en Geospatial Creator Origin, haz clic en Add Cesium Georeference Component.
9. En el cuadro de texto Google Maps Tile API Key, ingresa la clave de API y, luego, presiona Enter (o return en macOS).

3. Navega a la vista Scene de Unity

En este paso, verás la representación en 3D de la zona que te rodea.

Cambia la ubicación de la vista 3D

Para cambiar la ubicación de la vista previa de Photorealistic 3D Tiles a una zona cercana, sigue estos pasos:

1. En el panel Hierarchy, selecciona el objeto de juego AR Geospatial Creator Origin.
2. En el panel Inspector, sigue estos pasos para cambiar los valores de Latitude y Longitude a una ubicación cercana a la tuya:
   1. Usa Google Maps para encontrar una ubicación cerca de ti.
   2. Haz clic con el botón derecho en el mapa. Luego, selecciona las coordenadas que se proporcionan y cópialas en el portapapeles.
      Después de modificar los valores, cambiará la representación 3D del mundo en la ventana Scene:
      

Controla la cámara del viewport

Para encontrar una ubicación cercana en la que quieras colocar tu contenido anclado geoespacialmente, sigue estos pasos:

1. Usa las teclas de las flechas hacia arriba y hacia abajo para mover la cámara hacia delante y hacia atrás.
2. Usa las teclas de las flechas hacia la izquierda y hacia la derecha para desplazar lateralmente la vista.
3. Mantén presionada la tecla Shift para desplazarte más rápido.
4. Si te pierdes, en el panel Hierarchy, selecciona el objeto AR Geospatial Creator Origin y, luego, presiona la tecla F para volver a centrar la vista.

4. Importa y coloca un recurso 3D

Una vez que elijas una ubicación cerca de ti, deberás importar un recurso que aparezca en tu experiencia de RA y que esté anclado cerca de la ubicación seleccionada.

Importa un recurso 3D

Para ayudarte con este codelab, preparamos un recurso de muestra para que lo uses en tu proyecto.

Sigue estos pasos para importarlo:

1. file_downloadDescargar el recurso del tigre.
2. Extrae el archivo ZIP.
3. Haz clic en Assets > Import new asset. Se importarán los cuatro recursos al proyecto.
4. En el panel Project, arrastra el recurso Tiger model al panel Scene.

Cambia el tamaño del recurso y su posición

Para colocar tu recurso en el lugar adecuado, sigue estos pasos:

1. En el panel Hierarchy, asegúrate de que esté seleccionado el recurso Tiger model.
2. En la vista Scene, asegúrate de que esté habilitada la herramienta Scale. Luego, arrastra el cubo blanco para ajustar el tamaño del recurso como prefieras.
   
3. En la vista Scene, asegúrate de que esté habilitada la herramienta Move. Luego, selecciona los controles rojo, azul o verde y arrastra el mouse para cambiar la posición del recurso. Cada control de color bloquea una dimensión determinada y permite mover un objeto a lo largo de ese eje.
   

Ancla el recurso geoespacialmente

Para anclar tu contenido al mundo real, sigue estos pasos:

1. En el panel Hierarchy, asegúrate de que esté seleccionado el recurso Tiger model.
2. En el panel Inspector, presiona Add Component para agregar un AR Geospatial Creator Anchor.

5. Dale vida a tu recurso

El editor de Unity te permite programar increíbles experiencias de RA con la potencia del ecosistema de Unity.

Para hacer una animación en bucle del tigre a partir de una de las animaciones proporcionadas en el proyecto inicial, sigue estos pasos:

1. En el panel Hierarchy, selecciona Tiger model.
2. Haz clic en Add Component para agregar una animación.
3. En la sección Animator, selecciona un Controller y, luego, usa el recurso de controlador de animación Tiger idle proporcionado.

6. Visualiza el recurso en RA

Por último, visualiza el recurso en RA en tu dispositivo Android o iOS compatible con ARCore.

Ejecuta la app en tu dispositivo

1. Haz clic en File > Build Settings y, luego, selecciona las plataformas de compilación Android o iOS.
2. Haz clic en Switch platform.
3. Sigue los pasos adicionales para establecer la configuración del reproductor.
4. Asegúrate de que tu dispositivo de desarrollo esté conectado y configurado para el desarrollo.
5. Haz clic en Build and run.

7. Conclusión

¡Felicitaciones! Aprendiste a usar el Creador de Geospatial en Unity para crear una experiencia de RA geoespacial.

Más información

• Creador de Geospatial para Unity en Google Developers