Comenzar rápidamente con el desarrollo de EasyAR Mega Unity usando ejemplos

Este tutorial describe cómo configurar y ejecutar los ejemplos de EasyAR Mega Unity para comenzar rápidamente con el desarrollo de EasyAR Mega.

Antes de comenzar

Antes de leer este artículo, asegúrese de haber completado lo siguiente:

• Tener una biblioteca de localización en la nube válida.
• Instalar Unity (2021.3.30 LTS o superior). Se recomienda utilizar la última versión de Unity 2022.3 o Unity 6.3.
• Importar los paquetes com.easyar.sense-**.tgz y com.easyar.mega-**.tgz siguiendo el método descrito en Habilitar Mega.

Nota

Este tutorial solo es aplicable para el complemento de Unity con versión >= 4003. Si por casualidad ha descargado una versión anterior pero aún está leyendo la documentación de introducción, primero debe descargar la última versión del complemento.

Ejemplo de uso (seis pasos)

A continuación se describen seis pasos para configurar y ejecutar el ejemplo central de EasyAR Mega, MegaBlock_Basic.

Paso 1: Importar muestra

Nota

Si importó todas las muestras a través de **All Samples**, omita este paso.

1. Use el menú Window > Package Manager para abrir Package Manager, seleccione EasyAR Sense Unity Plugin. En el panel derecho, expanda todas las muestras en Samples.
2. Seleccione una muestra (por ejemplo, MegaBlock_Basic) y haga clic en Import.

Nota

• Este tutorial no es aplicable directamente a dispositivos de visualización montados en la cabeza (head-mounted displays), pero se requiere comprender el flujo usando un teléfono móvil para desarrollo antes de desarrollar para dichos dispositivos.
• Si importó previamente muestras de una versión anterior del SDK, después de actualizar el SDK, elimine primero las muestras antiguas y vuelva a importar las nuevas.

Paso 2: Configurar el SDK y el servicio de localización en la nube de Mega

1. En la barra de menú, selecciona EasyAR > Sense > Configuration;
   

2. En el panel Project Settings que se abre, pega tu License Key;
   

   Consejo

   La licencia de EasyAR Sense se puede crear desde el EasyAR Development Center. Para uso por primera vez, puedes seguir estos pasos para crearla:

   

   • Crear EasyAR Sense 4.x Personal Edition
   • Para Mapa espacial disperso, seleccionar No
   • El nombre de la aplicación se puede completar libremente. Para Bundle ID y Package Name, completar con com.mycompany.myproject
   • Seleccionar la licencia recién creada, ingresar y hacer clic en el botón de copiar en el lado derecho

   

   Nota

   El Bundle ID y el Package Name se pueden cambiar posteriormente, pero el número de cambios es limitado. Si tienes un nombre de paquete de aplicación específico, también puedes completar con tu propio nombre de paquete.

   La creación de la edición personal no tiene límite de cantidad. Para otros tipos, se pueden crear según sea necesario cuando se utilicen formalmente.

3. Verifica y activa la opción Mega > Mega Block/Landmark support en el panel Project Settings;
   

4. Configura la información de tu biblioteca de localización en la nube de Mega en el ítem Mega Block del panel Project Settings;
   

   Consejo

   La configuración de la biblioteca de localización en la nube de Mega se puede obtener desde el EasyAR Development Center.
   
   Asegúrate de que tu API Key tenga permisos para Mega Block y SpatialMap. Si no los tiene, es necesario realizar cambios o crearla nuevamente.
   
   Si no encuentras la biblioteca de localización, primero debes configurar correctamente la biblioteca de localización y verificar nuevamente que la biblioteca de localización en la nube sea válida.

Paso 3: configurar mega block

1. Configura Mega Block;

   Selecciona Mega Block y completa el ID y nombre del block.
   

   Consejo

   Block ID y el nombre se pueden obtener desde la biblioteca de localización correspondiente en el centro de desarrollo de EasyAR.
   
   Si no hay datos de block en la biblioteca de localización, debes añadir el block requerido en la biblioteca de localización y verificar nuevamente que la biblioteca de localización en nube sea válida.

Paso cuatro: colocar contenido 3d

1. Seleccione Mega Block y cree la herramienta del editor;

   

2. Verifique la información del servicio y conéctese al servicio;

   

   Consejo

   Si no hay otros cambios, la información del servicio debe ser la misma que la completada en Project Settings.

   Después de conectar correctamente el servicio, debería ver la hora de actualización y la interfaz de control de los datos del editor de Block.
   

3. Cargar los datos del editor de Block;

   Haga clic en el primer cuadro de selección bajo Datos de Block, esto iniciará el proceso de carga de los datos del editor de Block, después de cargar, podrá ver la malla del Block actual en la ventana de Escena:
   

   Consejo

   La malla de Block cambiará el LOD según la posición de la cámara, es necesario mantener la conexión a internet.

4. Colocar contenido 3d

   En este momento, puede hacer referencia a la malla de Block para colocar objetos 3D.
   

   Nota

   • Los objetos 3D deben colocarse debajo del nodo Block para asegurar que la posición de renderizado del contenido virtual sea correcta en tiempo de ejecución.
   • Los objetos 3D no pueden colocarse debajo del nodo EasyAR.Mega.EditorTool, este nodo solo se usa para la herramienta del editor, en algunos casos será eliminado o reconstruido automáticamente.

Paso 5: modificar la configuración del jugador

• Android
• iOS

En el menú de Unity, vaya a Archivo > Configuración de compilación > Configuración del jugador, haga clic en el icono de Android para abrir la configuración correspondiente de la plataforma Android.

• Cambie el nombre del paquete al nombre del paquete mostrado en la página de la clave de licencia

  

  Consejo

  Por ejemplo, si el nombre del paquete que completó al crear la clave de licencia es com.mycompany.myproject, debe completar el nombre del paquete aquí como com.mycompany.myproject, de lo contrario la ejecución fallará.

• Cambie el nivel mínimo de API a Nivel de API 24 o superior

  

9. Cambie el backend de scripting a IL2CPP y marque ARM64 en Arquitectura de destino

Paso 6: construir y ejecutar

1. Añade la escena actual en File > Build Settings o Build Profiles > Scene List;
   
2. Cambia a la plataforma objetivo (por ejemplo Android / iOS), comprueba que el nombre del paquete (Bundle ID) coincida con la License Key;
   
3. Haz clic en Build And Run.
   

El efecto de ejecución grabado en el lugar es el siguiente:

Sobre la escritura amarilla en la pantalla

Durante la ejecución, es posible que vea dos mensajes en amarillo mostrados en la pantalla.

1. Advertencia de ejecución de simulación Está ubicada en la parte inferior de la pantalla:

   

   Esta advertencia aparece porque, con la configuración predeterminada, la aplicación puede ejecutarse sin estar on-site. Tiene un ligero impacto en el rendimiento de la aplicación. Si está usando la aplicación on-site, puede modificar la configuración de MegaTracker antes de crear el paquete.

2. Información de diagnóstico Está ubicada en la parte superior de la pantalla. Se utiliza para conocer el estado de funcionamiento y los problemas de la sesión. Se recomienda mantenerla visible durante las fases de desarrollo y prueba:

   

   Puede consultar La información de diagnóstico en la escena para comprender rápidamente cómo configurar y usar esta información de diagnóstico.

Próximos pasos: de principiante a experto

¡Felicidades! Siguiendo los pasos anteriores, ha ejecutado con éxito los ejemplos principales de EasyAR Mega en 10 minutos, experimentando de primera mano el encanto de la localización espacial y la superposición de contenido AR.

Ahora que domina los conceptos básicos. Si desea:

• Construir aplicaciones AR más estables y eficientes
• Lograr efectos complejos como oclusión mixta, alineación de contenido, etc.
• Depurar cuando no disponga de dispositivos o no pueda acudir al sitio

Consulte las siguientes guías detalladas. Le ayudarán a resolver problemas prácticos durante el desarrollo.

Desarrollo avanzado

Si desea conocer la configuración completa de ingeniería, puede consultar el siguiente contenido:

• Uso de Universal Render Pipeline (URP)
• Configuración del Player
• Configuración de EasyAR

Si desea comprender más a fondo el uso de EasyAR, puede comenzar desde aquí:

• Fundamentos de aplicaciones Unity impulsadas por AR

También se recomienda leer el siguiente contenido para ayudarle en el desarrollo y depuración:

• Diagnóstico y reporte de problemas en el desarrollo con Unity
• Simulación de AR en Unity

Control preciso de las funciones Mega

El contenido a continuación te ayudará a utilizar mejor Mega en tu aplicación:

• Uso in situ y simulación
• Mejores prácticas de ARSession
• Añadir objetivos de seguimiento
• Crear contenido 3D alineado con el mundo real
• Oclusión ambiental (Occlusion)
• Controlar el proceso de seguimiento

El contenido a continuación te ayudará a verificar las funciones Mega sin necesidad de desplazarte al lugar:

• Verificación rápida con cámara de PC
• Simulación con herramienta de verificación de Session

Temas avanzados

El siguiente contenido es más adecuado para leer después de tener cierta experiencia con EasyAR.

Si deseas ejecutar EasyAR Mega en un visor, puedes consultar:

• Soporte para visores de EasyAR en Unity
• Usar muestras de EasyAR en visores XR o gafas

Si deseas usar AR Foundation, puedes comenzar aquí:

• Soporte de EasyAR para el framework XR de Unity