Escenas de RA

Qué hace

Las escenas de RA definen el contenido de realidad aumentada que los jugadores ven cuando apuntan su dispositivo a una imagen marcadora del mundo real. Cada escena mapea un marcador impreso a uno de tres tipos de contenido: una imagen de reemplazo, un vídeo o un objeto 3D. Las escenas se asignan a retos de tipo RA (AR Shell, MooveXR, MooveGoXR) para que los jugadores experimenten contenido aumentado durante el juego.

Requisitos

• Debes tener sesión activa con el rol admin o agencia
• Las imágenes marcadoras deben estar subidas a la Galería antes de crear escenas
• Para contenido 3D, los modelos deben estar subidos a la Galería 3D primero

Cómo acceder

Desplegable de usuario (arriba a la derecha) → AR Scenes

Lista de escenas de RA

Lista de escenas

La vista principal muestra todas las escenas de RA pertenecientes a la empresa actual.

Columna	Tipo	Descripción
(Acciones)	Iconos	Editar (lápiz) y eliminar (papelera) por fila
Scene Name	Visualización	Nombre de la escena de realidad aumentada

Acciones

Acción	Descripción
New	Abre el formulario de creación de escena
Edit (lápiz)	Abre el formulario de edición de una escena existente
Delete (papelera)	Elimina la escena tras confirmación

Formulario de creación / edición

Campo	Tipo	Descripción	Obligatorio
Scene Name	Texto (máx. 100)	Nombre visible de la escena	Sí
Image to Augment	Selector de imagen (Galería)	La imagen marcadora del mundo real que activa la superposición de RA	Sí
Type of Augmentation	Selector	Tipo de contenido: Image, Video o 3D Object	Sí
Augmented Image	Selector de imagen (Galería)	La imagen superpuesta (visible cuando tipo = Image)	Condicional
Video	Selector (Characters/Videos)	El vídeo superpuesto (visible cuando tipo = Video)	Condicional
3D Object	Selector (Gallery 3D)	El modelo 3D a mostrar (visible cuando tipo = 3D Object)	Condicional
Width in cm	Número (8-200)	Anchura física del marcador impreso en centímetros — utilizado por el motor de RA para un seguimiento de escala preciso	Sí
Transform Scale	XYZ (X, Y, Z)	Multiplicador de escala para el contenido aumentado	No
Transform Position	XYZ (X, Y, Z)	Desplazamiento de posición relativo al centro del marcador	No
Transform Rotation	XYZ (X, Y, Z)	Rotación en grados para cada eje	No

Comportamiento y reglas

• El tipo determina los campos obligatorios. Seleccionar “Image” requiere una Augmented Image; “Video” requiere un personaje de vídeo; “3D Object” requiere una entrada de Galería 3D. El formulario muestra/oculta secciones condicionalmente según el tipo seleccionado.
• Alcance por empresa. Cada empresa solo ve sus propias escenas. El filtro de ID de empresa se aplica en el servidor.

Nota

El campo Width in cm (8-200) indica al motor de RA el tamaño real del marcador físico en el mundo real. Una medición precisa es fundamental para los cálculos correctos de profundidad y escala en la vista de RA.

• Los objetos 3D provienen de la Galería 3D — tanto los modelos públicos como los modelos privados de la empresa están disponibles.
• Las propiedades de transformación controlan cómo se posiciona, escala y rota el contenido aumentado respecto al marcador. Los valores predeterminados son de identidad (sin transformación).
• Las escenas se asignan a retos. Al configurar un AR Shell u otro tipo de reto de RA, selecciona qué escena usar.

Peligro

Eliminar una escena que está asignada a retos quita la referencia de escena de esos retos. Verifica que ningún evento activo use la escena antes de eliminarla.

Integración con la app móvil

Dos endpoints internos de API sirven datos de escenas de RA a las apps móviles: uno devuelve una única escena con URLs completamente resueltas de imagen/vídeo/modelo 3D, y el otro devuelve todas las escenas de la empresa del usuario autenticado. Ambos requieren autenticación (usuario + contraseña) y devuelven datos de escena con URLs absolutas para todos los activos de medios.

Páginas relacionadas

• Galería 3D — Gestión de modelos 3D (fuente de selecciones de 3D Object)
• Objetos 3D en el mapa — Cómo aparecen los objetos 3D durante el juego
• Paquete de RA Metaio — Subida de paquetes de contenido de RA legacy
• AR Shell (Tipo de reto) — El tipo de reto que usa escenas de RA
• Galería — Galería de imágenes/vídeos (fuente de marcadores e imágenes aumentadas)