Comienza rápidamente con los ejemplos de EasyAR Unity

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

Preparar proyecto vacío de Unity

Asegúrate de tener instalada una versión compatible de Unity (Unity 2021.3 o superior). Se recomienda utilizar la última versión de Unity 2022.3 o Unity 6.3.

Crea un proyecto vacío de Unity utilizando la plantilla 3D (Built-in Render Pipeline):

Nota

No se recomienda usar URP para usuarios principiantes.

Si estás usando Unity 6, necesitas descargar manualmente y usar la 3D (Built-In Render Pipeline) Template. En una instalación predeterminada, se encuentra en una posición posterior en la lista de plantillas.

Importante

Para usar URP, debes realizar configuraciones adicionales siguiendo Universal Render Pipeline (URP), de lo contrario, la imagen de la cámara no se mostrará.

Importar EasyAR Sense Unity Plugin

• Descargar el paquete del plugin
  • Descarga la última versión del EasyAR Sense Unity Plugin, que incluye ejemplos (sample).
  • Tras descomprimir el archivo zip, verás un readme y archivos .tgz. Los archivos .tgz se importan directamente en Unity, no los descomprimas.
  • Guarda el archivo .tgz en la carpeta Packages del proyecto Unity.
• Importar el paquete del plugin
  • En la barra de menú, haz clic en Window y selecciona Package Manager.
  • En la ventana emergente, haz clic en el símbolo + (arriba a la izquierda) y elige Install Package from tarball....
  • En el diálogo, selecciona el archivo .tgz mencionado anteriormente.

Nota

El archivo .tgz no debe eliminarse ni moverse después de importarlo en Unity. Antes de importar, colócalo en una ubicación adecuada. Se recomienda guardarlo en la carpeta Packages del proyecto Unity para facilitar la gestión de versiones.

Importar muestras

Usa el menú Window > Package Manager para abrir Package Manager, selecciona EasyAR Sense Unity Plugin, y en el lado derecho elige **All Samples** para importar todas las muestras de una vez.

[!PRECAUCIÓN] **All Samples** y otras muestras no se pueden importar simultáneamente, de lo contrario aparecerán activos duplicados que provocarán la pérdida de recursos en algunas escenas. Si accidentalmente importas archivos duplicados, debes eliminarlos y volver a importar.

Modificar lista de escenas

Abre Build Settings (o Build Profiles),

Agrega las escenas de ejemplo del proyecto Unity a la Scene List de Build Settings o Build Profiles, y mueve la escena del lanzador de ejemplos (AllSamplesLauncher) al primer lugar entre todas las escenas.

Precaución

Ten cuidado de no agregar estas escenas de dispositivos de realidad aumentada, de lo contrario el empaquetado podría fallar:

• Combination_BasedOn_AppleVisionPro.rst
• Combination_BasedOn_Xreal.rst

Rellenar la licencia (License Key)

Desde el menú de Unity, selecciona EasyAR > Sense > Configuration para abrir la interfaz de configuración de EasyAR Sense.

En el campo de texto bajo EasyAR Sense License, ingresa la EasyAR Sense License.

Consejo

La EasyAR Sense License puede crearse desde el Centro de desarrollo de EasyAR (中文, 英文). Para uso inicial, puedes crearla siguiendo estos pasos:

• Crea una EasyAR Sense 4.x Personal Edition.
• En mapa espacio escaso, selecciona Sí. El nombre puede ser cualquiera.
• El nombre de la aplicación puede ser cualquiera. En Bundle ID y Package Name, ingresa com.mycompany.myproject.
• Selecciona la licencia recién creada y haz clic en el botón de copiar a la derecha.

Nota

Bundle ID y Package Name pueden cambiarse posteriormente, pero con un número de veces limitadas. Si ya tienes un nombre de paquete definido para tu aplicación, también puedes ingresarlo.

La creación de ediciones personales no tiene límites. Otros tipos pueden crearse según sea necesario durante el uso formal.

En editores

Ejecutar en el editor requiere que tenga una cámara web conectada a su computadora.

Confirmar que la cámara del sistema funciona correctamente

Abre la aplicación de cámara del sistema:

Verifica que la cámara funciona correctamente:

Finalmente, asegúrate de cerrar la aplicación de cámara para evitar conflictos al ejecutar los ejemplos.

Nota

EasyAR solo utiliza las interfaces proporcionadas por el sistema para acceder a la cámara. Asegúrate de que la aplicación de cámara del sistema pueda abrir la cámara y mostrar la imagen correctamente.

Ejecución de ejemplo

El siguiente contenido toma el ejemplo de seguimiento de imágenes ImageTracking_Targets como referencia. Otros ejemplos se ejecutan de manera similar.

Abre la escena del lanzador de ejemplos y haz clic en el botón Play en la parte superior del editor de Unity.

Ingresa a la escena ImageTracking_Targets.

Consejo

También puedes abrir directamente la escena ImageTracking_Targets y ejecutarla.

Apunta la cámara hacia la siguiente imagen de reconocimiento:

Enlace de descarga: 🔗 namecard

EasyAR reconocerá y rastreará esta imagen, superponiendo objetos virtuales.

Nota

Algunas funciones no pueden ejecutarse conectando la cámara en el editor, pero sí en dispositivos móviles. Los ejemplos incompatibles mostrarán una ventana emergente de fallo al iniciarse.

Simultáneamente, se mostrarán mensajes informativos y registros de error.

Ejecutar en teléfonos móviles

Para ejecutar en teléfonos móviles es necesario empaquetar. Antes de empaquetar, se debe modificar la configuración del Player.

Modificar la configuración del reproductor

• Android
• iOS

En el menú de Unity File > Build Settings > Player Settings, haz clic en el ícono de Android para acceder a la configuración específica de la plataforma Android.

• Modifica Package Name al Package Name mostrado en la página de License Key

  

  [!CONSEJO] Por ejemplo, si el Package Name que ingresaste al crear la License Key fue com.mycompany.myproject, debes establecer aquí el Package Name como com.mycompany.myproject, de lo contrario, fallará.

• Modifica Minimum API Level a API Level 21 o superior

  

• Modifica Scripting Backend a IL2CPP y marca ARM64 en Target Architecture

  

Empaquetar aplicaciones

Selecciona File > Build Settings, elige la plataforma objetivo (Android/iOS) y luego selecciona switch platform.

Selecciona Build o Build And Run para compilar el proyecto e instalarlo en el teléfono. Durante la ejecución, se deben otorgar los permisos correspondientes.

Ejemplo de ejecución

El siguiente contenido toma como ejemplo el seguimiento de imágenes ImageTracking_Targets. La ejecución de otros ejemplos es similar.

Después de ejecutar, se iniciará la escena del lanzador de ejemplos.

Consejo

Si al abrir no se ingresa a la escena del lanzador de ejemplos, verifique si configuró correctamente la lista de escenas en Build Settings o Build Profiles, y mueva AllSamplesLauncher al primer lugar.

Ingrese a la escena ImageTracking_Targets.

Apunte la cámara del teléfono hacia la siguiente imagen de reconocimiento:

Dirección de descarga: 🔗 namecard

EasyAR reconocerá y seguirá esta imagen, superponiendo objetos virtuales.

Próximos pasos

Ha ejecutado con éxito el ejemplo de AR de Unity y puede estar interesado en cómo se creó la escena AR que muestra el ejemplo. Puede leer las siguientes guías de introducción en orden:

• Habilitar EasyAR
• Configurar la escena AR
• Información de diagnóstico en la escena

Para el iniciador de ejemplos, puede consultar las instrucciones detalladas de uso:

• Instrucciones de uso del iniciador de ejemplos

Si desea comprender la configuración completa del proyecto, puede consultar lo siguiente:

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

Si desea obtener más información sobre cómo usar EasyAR, puede comenzar aquí:

• Fundamentos de aplicaciones Unity impulsadas por AR