Guía de Solución de Problemas

¿Tienes problemas con Visualizador GLTF? Esta guía cubre los problemas más comunes y sus soluciones.

Problemas de Carga de Archivos

❌ El Archivo No Se Carga

Posibles causas:

• Formato de archivo no compatible
• Archivo demasiado grande
• Problemas de conexión de red

Soluciones:

❌ La Carga Comienza Pero Falla

Soluciones:

• Verifica tu conexión a internet
• Intenta cargar un archivo más pequeño primero
• Limpia la caché de tu navegador e intenta de nuevo

Problemas de Visualización del Modelo

❌ El Modelo 3D No Carga

Soluciones comunes:

1. Actualiza la página e intenta de nuevo
2. Limpia la caché del navegador:
   • Chrome: Configuración > Privacidad y seguridad > Borrar datos de navegación
   • Firefox: Configuración > Privacidad y Seguridad > Borrar Datos
   • Safari: Menú Safari > Borrar Historial
3. Desactiva las extensiones del navegador temporalmente
4. Intenta en modo incógnito/navegación privada

❌ El Modelo Aparece Corrupto o Con Partes Faltantes

Esto puede ocurrir cuando:

• El archivo glTF/GLB original tiene errores
• El archivo no fue exportado correctamente o tiene problemas de formato (glTF (JSON) vs GLB (binario))
• El modelo es extremadamente complejo

Soluciones:

1. Re-exporta el archivo desde tu software de modelado 3D original como glTF/GLB
2. Simplifica el modelo antes de exportar para reducir el número de polígonos
3. Prueba diferentes configuraciones de exportación glTF (GLB binario suele ser más confiable que glTF JSON para empaquetado)

❌ El Modelo Carga Pero Se Ve Incorrecto

Verifica estas configuraciones en tu software de modelado 3D/laminado:

• Unidades de exportación (mm, pulgadas, etc.)
• Configuraciones de precisión de exportación
• Incluir toda la geometría en la exportación

Problemas de Rendimiento

🐌 Carga Lenta

Para archivos grandes:

• La carga puede tomar varios minutos para modelos complejos
• Archivos mayores a 50MB pueden ser muy lentos
• Considera simplificar tu modelo

Para mejor rendimiento:

• Cierra otras pestañas del navegador
• Asegúrate de tener una conexión fuerte a internet
• Usa una computadora con gráficos dedicados

🐌 Rotación/Zoom del Modelo Lento

Soluciones:

1. Cierra otras aplicaciones para liberar recursos del sistema
2. Usa Google Chrome para mejor rendimiento
3. Reduce la resolución de tu pantalla temporalmente
4. Reinicia tu navegador

Compatibilidad de Navegadores

✅ Navegadores Totalmente Compatibles

• Google Chrome 90+ (Recomendado)
• Microsoft Edge 90+
• Mozilla Firefox 88+
• Safari 14+

❌ Navegadores No Compatibles

• Internet Explorer (todas las versiones)
• Versiones muy antiguas de navegadores
• Algunos navegadores móviles

Problemas en Dispositivos Móviles

Si Visualizador GLTF no funciona bien en móvil:

• Usa una tablet en lugar de teléfono para mejor experiencia
• Prueba escritorio/laptop para modelos complejos
• Asegúrate de que tu navegador móvil esté actualizado

Red y Conectividad

🌐 Soluciones para Red Lenta

Conexión recomendada:

• Velocidad de descarga: Al menos 5 Mbps
• Conexión estable (evita WiFi público para archivos grandes)

Si experimentas problemas de red:

1. Prueba la velocidad de tu conexión en speedtest.net
2. Prueba una red diferente si es posible
3. Carga archivos en horas de menor tráfico

¿Sigues Teniendo Problemas?

Antes de Contactar Soporte

1. Anota la versión de tu navegador (Ayuda > Acerca de en la mayoría de navegadores)
2. Anota tu sistema operativo (Windows, Mac, etc.)
3. Anota el mensaje de error exacto (toma una captura de pantalla)
4. Prueba con un archivo glTF/GLB diferente para ver si el problema persiste

Lista de Verificación Rápida para Solución de Problemas

• ✅ ¿Estás usando un navegador compatible?
• ✅ ¿Tu navegador está actualizado?
• ✅ ¿El archivo está en formato glTF/GLB (.gltf/.glb)?
• ✅ ¿El archivo es menor a 100 MB?
• ✅ ¿Tienes buena conexión a internet?
• ✅ ¿Intentaste actualizar la página?
• ✅ ¿Intentaste en modo incógnito/privado?

La mayoría de los problemas se pueden resolver actualizando tu navegador o probando con un archivo diferente. Visualizador GLTF funciona mejor con navegadores modernos y archivos glTF/GLB bien formateados.