Crear y cargar anotaciones con el editor de Unity
Este artículo explica cómo crear y cargar anotaciones usando Mega Studio en el editor de Unity.
Antes de empezar
Preparar el modelo: Usar el modelo del proyecto de ejemplo (un adorable panda), o usar el modelo de robot pequeño del Demo oficial de xr-frame, o preparar un archivo de modelo que cumpla con los requisitos de xr-frame consultando el formato GLTF cargable por XRFrame y extensiones admitidas.
Importar los archivos del modelo a Unity.
Consejo
La dependencia de com.unity.cloud.gltfast ya se ha agregado al complemento Mega, por lo que puedes arrastrar directamente los archivos del modelo a los Assets de Unity.
Por qué se necesitan anotaciones
EasyAR Mega Annotation (EMA) se puede usar para sincronizar posiciones espaciales entre plataformas (con diferentes definiciones de sistemas de coordenadas).
Sistema de coordenadas local de la anotación en el entorno de Unity: La dirección positiva de X apunta hacia atrás, la dirección positiva de Y apunta hacia arriba, la dirección positiva de Z apunta hacia la derecha.
Sistema de coordenadas local de la anotación en el entorno de xr-frame: La dirección positiva de X apunta hacia atrás, la dirección positiva de Y apunta hacia arriba, la dirección positiva de Z apunta hacia la izquierda.
Las diferencias de dirección anteriores se originan por las diferentes definiciones de sistemas de coordenadas (mano izquierda/derecha) utilizadas por Unity y xr-frame.
Usar EMA para sincronizar posiciones espaciales ofrece estas ventajas significativas:
- Simplifica el flujo de desarrollo: Maneja automáticamente la conversión de coordenadas multiplataforma, evitando la lógica engorrosa y propensa a errores de los cálculos manuales.
- Mejora la eficiencia de depuración: Permite cargar directamente en MegaToolbox, facilitando pruebas rápidas en dispositivos reales y validación de datos.
Pasos de operación
Crear herramienta de anotación
En el panel Hierarchy de Unity, haz clic derecho y selecciona: EasyAR Mega > Tool > Annotation Tool (Edit Mode).
Tras la creación, se generarán los nodos EasyAR.Mega.Annotation y MegaBlocks en la escena.
Selecciona el nodo EasyAR.Mega.Annotation. En su panel Inspector, aparecerán campos para ingresar usuario/correo y contraseña.
Iniciar sesión
Ingresa tu cuenta de EasyAR y contraseña. Al iniciar sesión correctamente, aparecerán las herramientas de Studio en el panel Inspector.
Seleccionar biblioteca de ubicación Mega Cloud
Haz clic en el ícono a la derecha de Mega Cloud Service.
Selecciona la biblioteca a utilizar.
Tras cargar exitosamente la biblioteca y la información de Mega Blocks, el panel de herramientas Studio se mostrará así:
Cargar modelo denso del Block
Haz clic en Cargar a la derecha del nombre del Block para cargar dinámicamente su modelo denso.
El modelo cargado aparecerá en la pestaña Scene. Nota: cuando aparezca el indicador inferior izquierdo (como en la imagen), partes del modelo en tu campo visual aún no se han cargado. Espera a que desaparezca para confirmar la carga completa.
Crear anotación
Mantén presionada la tecla Ctrl (Windows) / Command (Mac) en la escena y haz clic izquierdo donde necesites anotar.
Usar modelos
Arrastra el modelo importado a la escena como nodo hijo de la anotación.
En el panel Inspector del modelo, establece Position y Rotation en 0. Ajusta Scale según sea necesario.
Nota
EMA gestiona toda la lógica de transformación de coordenadas. Configurar Position y Rotation en 0 asegura que el centro geométrico del modelo coincida exactamente con el punto de anotación. Todos los ajustes de posición/rotación deben realizarse mediante su nodo padre (nodo de anotación).
[Opcional] Ajustar posición del modelo con precisión
Para ajustes precisos de posición/orientación, consulta Cómo usar el editor de Unity para alinear contenido 3D con el mundo real.
Crear nuevo paquete de datos de anotación
Haz clic en el ícono a la derecha de "paquete de datos de anotación" en el panel Inspector.
Ingresa un nombre para los datos de anotación y haz clic en la marca de verificación.
Tras la creación exitosa, verás esto. Luego haz clic en "Aceptar".
Haz clic en el ícono de subida para cargar.
Al subir exitosamente, aparecerá una notificación.
Registrar ID de la anotación
Debes registrar el nombre o ID de los datos de anotación para cargarlos en xr-frame.
Tras la subida exitosa, también verás la información correspondiente en tu biblioteca de ubicación en la nube.
Aquí también puedes ver el nombre e ID de los datos de anotación subidos.
Próximos pasos
- Crear contenido 3D alineado con el mundo real usando el editor de Unity
- Probar simular la ejecución en el editor de Unity
- Ejecutar completamente el proyecto de ejemplo