AVANT D'EXPÉDIER

Compression GLB et compatibilité des visionneuses

Une extension de fichier GLB ne garantit pas que chaque application peut charger son contenu. Vérifiez les extensions utilisées par la sortie et testez votre destination.

Faites correspondre les paramètres à votre chargeur

Ces exigences peuvent se combiner. Le panneau de résultats rapporte des informations de compatibilité pour votre sortie. Notre aperçu inclut des décodeurs, donc un aperçu réussi ne prouve pas que votre propre application les a configurés.

Les préréglages utilisent la quantification géométrique par défaut. Sa désactivation peut supprimer l'exigence de quantification géométrique, mais Meshopt ou les textures converties ont toujours besoin de leurs chargeurs correspondants. Vérifiez les extensions signalées pour le résultat réel.

Utiliser Three.js

Configurez un décodeur Meshopt via GLTFLoader.setMeshoptDecoder() pour la géométrie compressée. Pour KTX2, configurez un KTX2Loader, détectez la prise en charge du moteur de rendu et attachez-la via setKTX2Loader(). Servez les actifs de transcodeur correspondants avec votre application. Consultez le Documentation du chargeur GLTFLoader et Documentation du chargeur KTX2 pour votre version.

Exemple : l'original se charge, mais l'exportation de fichiers plus petits ne se fait pas

Conservez les textures originales et exportez la même source deux fois : une fois avec Conservateur et une fois avec un fichier Plus petit. Si seul le deuxième fichier échoue dans votre application, vérifiez les extensions signalées et l'erreur du chargeur avant de modifier les paramètres de géométrie. Cette comparaison réduit le problème à une exigence de chargement modifiée ; cela ne prouve pas que chaque panne soit due à un décodeur manquant.

Pour un résultat EXT_meshopt_compression dans Three.js, enregistrez MeshoptDecoder avant le chargement. Réessayez ensuite ce même fichier exporté. La réexportation sans compression est une solution de secours lorsque la destination ne peut pas être modifiée, au prix d'un téléchargement potentiellement plus volumineux.

Exemple : les textures originales fonctionnent, mais KTX2 échoue après le déploiement

Conservez les paramètres de géométrie fixes et comparez les textures originales avec KTX2. Pour une application Three.js, vérifiez que KTX2Loader est connecté et que detectSupport a été exécuté. Inspectez les requêtes pour basic_transcoder.js et basic_transcoder.wasm. Une réponse 404 ou une page d'application HTML renvoyée à ces URL indique une livraison d'actifs plutôt qu'une qualité de texture.

Testez à nouveau la même sortie KTX2 après avoir corrigé le chemin du chargeur ou de l'actif, y compris sur un appareil mobile cible. Un fichier chargé dans l’aperçu de ce site a réussi la configuration de cette visionneuse ; votre visionneuse de production doit toujours satisfaire ses propres exigences de chargement.

Noms, extras et comportement de la scène

Les trois bascules de préservation sont activées par défaut. Laissez-les activés lorsque votre application recherche des objets ou des matériaux par leur nom ou lit extras. Ils ne promettent pas d'indices de nœuds, de hiérarchie, d'échantillons d'animation ou d'attributs personnalisés identiques. L'optimisation peut fusionner ou réorganiser les données et modifier la précision.

Sélection de tests, modifications de matériaux, lecture d'animations, cibles de morphing et transformations d'objets dans l'application réelle. Conserver extras n’est pas un moyen de conserver des extensions personnalisées arbitraires.

Restrictions d'entrée

Ce service rejette les entrées compressées Draco, les ressources externes et les extensions requises non prises en charge. Les extensions facultatives inconnues peuvent être ignorées. Exportez une ressource GLB non compressée et intégrée à partir de l'application source si nécessaire.

Pour la liste des extensions et le comportement d'optimisation du moteur, voir documentation gltfpack en amont. Le service Web applique des limites de validation et de ressources supplémentaires.

Charger les modèles gltfpack dans Three.js →