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:
- Deduplicación — Elimina accessors, materiales, mallas y texturas duplicados para reducir la redundancia.
- Poda — Elimina nodos, materiales y otros recursos sin usar que no contribuyen al modelo visible.
- Soldadura — Combina los vértices que comparten la misma posición y los mismos atributos, lo que reduce la cantidad de vértices.
- 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.
- 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.
- Compresión de texturas — Convierte las texturas al formato WebP para obtener archivos más pequeños sin perder calidad visual.
- 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.