Saltar al contenido principal

Referencia

Especificaciones de los modelos 3D

Especificaciones de los modelos 3D

Esta página ofrece una referencia técnica detallada del proceso de generación y optimización de modelos 3D que se usa en 3D Menu Pro.

Formato de salida

Todos los modelos 3D se entregan como archivos GLB (glTF Binary). GLB es un estándar de la industria para contenido 3D en la web, compatible con todos los navegadores principales y frameworks, incluidos Three.js y el componente web <model-viewer>.

Límite de tamaño

El tamaño máximo de un modelo optimizado final es de 2 MB. Los modelos que superan este límite después de la primera pasada de optimización se simplifican automáticamente. La simplificación automática se activa cuando el modelo supera los 2 MB y la cantidad de polígonos es superior a 10,000. Si no hay datos sobre la cantidad de polígonos, el sistema aplica la simplificación de forma predeterminada como medida de seguridad.

Proceso de optimización

Cada modelo 3D generado pasa por un proceso de optimización de varias etapas para garantizar una carga rápida en dispositivos móviles:

  1. Deduplicación — Elimina accessors, materiales, mallas y texturas duplicados para reducir la redundancia.
  2. Poda — Elimina nodos, materiales y otros recursos sin usar que no contribuyen al modelo visible.
  3. Soldadura — Combina los vértices que comparten la misma posición y los mismos atributos, lo que reduce la cantidad de vértices.
  4. Simplificación — Reduce la cantidad de polígonos y preserva la fidelidad visual. Usa la biblioteca meshoptimizer para una decimación de mallas que tiene en cuenta la calidad.
  5. Cuantización — Reduce la precisión de los atributos de los vértices (posiciones, normales, UV) para usar menos memoria con un impacto visual mínimo.
  6. Compresión de texturas — Convierte las texturas al formato WebP para obtener archivos más pequeños sin perder calidad visual.
  7. Compresión Draco — Aplica la compresión de mallas Draco para la reducción final del tamaño del archivo. El navegador decodifica Draco en el momento de la carga.

Estados del modelo

Estado Descripción Duración
PENDING El artículo está en la cola de procesamiento, a la espera de un worker disponible. Varía según la longitud de la cola
GENERATING El proveedor de IA está generando un modelo 3D a partir de la foto de entrada. De 30 segundos a 2 minutos
PROCESSING El modelo generado se está optimizando mediante el proceso descrito arriba. De 10 a 30 segundos
READY El modelo está optimizado y publicado en el menú público. Estado final
FAILED El procesamiento encontró un error. Se puede reintentar desde el panel. Estado final (hasta que se reintente)

Tiempos de espera de descarga

El sistema aplica tiempos de espera durante la entrega de los modelos para evitar experiencias de carga lenta:

  • Descarga de la imagen de póster: tiempo de espera de 30 segundos
  • Descarga del modelo: tiempo de espera de 120 segundos

Si se agota el tiempo de espera de la descarga de un modelo, el visor recurre a la imagen de póster (foto mejorada) para que el cliente siempre vea algo.

Compatibilidad con WebGL

Los modelos 3D se renderizan con WebGL en el navegador. Si WebGL no está disponible o se pierde el contexto (lo que puede ocurrir en dispositivos móviles con poca memoria), el visor recurre automáticamente al componente web <model-viewer>, que ofrece una amplia compatibilidad. Si no se admite ni WebGL ni model-viewer, se muestra en su lugar la foto 2D mejorada.