ANTES DE PONERLO EN USO

Compresión de GLB y compatibilidad con visores

La extensión .glb no garantiza que cualquier aplicación pueda cargar el contenido del archivo. Revisa las extensiones utilizadas en el resultado y pruébalo en su destino.

Elige ajustes compatibles con tu cargador

Estos requisitos pueden combinarse. El panel de resultados muestra información de compatibilidad del archivo de salida. Nuestra vista previa incluye decodificadores, por lo que verla funcionar no demuestra que tu aplicación los tenga configurados.

Los ajustes preestablecidos utilizan cuantización geométrica de forma predeterminada. Desactivarla puede eliminar ese requisito, pero Meshopt y las texturas convertidas siguen necesitando sus cargadores correspondientes. Comprueba las extensiones indicadas para el resultado concreto.

Uso con Three.js

Para la geometría comprimida con Meshopt, registra el decodificador con GLTFLoader.setMeshoptDecoder(). Para las texturas KTX2, configura KTX2Loader, detecta la compatibilidad del renderizador y conéctalo con setKTX2Loader(). Sirve los archivos correspondientes del transcodificador junto con tu aplicación y consulta la documentación de tu versión de Three.js.

documentación de GLTFLoader · documentación de KTX2Loader

Ejemplo: el original se carga, pero el resultado de «Archivo más pequeño» no

Conserva las texturas originales y exporta la misma fuente dos veces: una con «Conservador» y otra con «Archivo más pequeño». Si solo falla la segunda en tu aplicación, revisa las extensiones indicadas y el error del cargador antes de cambiar los ajustes geométricos. Esta comparación acota el problema a un cambio en los requisitos de carga; no demuestra que todos los fallos se deban a un decodificador ausente.

Para un resultado con EXT_meshopt_compression en Three.js, registra MeshoptDecoder antes de cargarlo. Después vuelve a probar ese mismo archivo exportado. Si no puedes modificar la aplicación de destino, una alternativa es exportar de nuevo con la compresión desactivada, aunque la descarga puede ser mayor.

Ejemplo: las texturas originales funcionan, pero KTX2 falla tras el despliegue

Mantén los mismos ajustes geométricos y compara las texturas originales con KTX2. En una aplicación Three.js, comprueba que KTX2Loader esté conectado y que se haya ejecutado detectSupport. Inspecciona las solicitudes de basis_transcoder.js y basis_transcoder.wasm. Si esas direcciones devuelven un error 404 o una página HTML de la aplicación, el problema está en cómo se sirven los recursos, no en la calidad de la textura.

Tras corregir el cargador o la ruta de los recursos, vuelve a probar el mismo archivo KTX2, también en un dispositivo móvil de destino. Un archivo que se abre en la vista previa de este sitio funciona con la configuración de este visor; el visor de producción aún debe cumplir sus propios requisitos de carga.

Nombres, extras y comportamiento de la escena

Las tres opciones de conservación están activadas de forma predeterminada. Mantenlas así si tu aplicación busca objetos o materiales por nombre o lee extras. No garantizan que los índices de nodos, la jerarquía, las muestras de animación o los atributos personalizados sean idénticos. La optimización puede unir o reorganizar datos y modificar la precisión.

Prueba la selección, los cambios de material, las animaciones, los objetivos de deformación y las transformaciones de objetos en la aplicación real. «Conservar extras» no permite conservar cualquier extensión personalizada.

Restricciones de entrada

Este servicio rechaza archivos comprimidos con Draco, recursos externos y extensiones obligatorias no compatibles. Las extensiones opcionales desconocidas podrían descartarse. Cuando sea necesario, exporta desde la aplicación de origen un GLB sin comprimir y con los recursos incorporados.

Para consultar la lista de extensiones y el comportamiento de optimización del motor, ve a la documentación oficial de gltfpack. El servicio web aplica validaciones y límites de recursos adicionales.

Cargar modelos de gltfpack en Three.js →