Quand quelque chose ne tourne pas rond

Dépannage de l'optimisation GLB

Conservez votre fichier source. La plupart des problèmes peuvent être isolés en revenant au préréglage Conservateur et en modifiant une option par exécution.

"Choisissez un fichier .glb autonome"

Renommer un fichier .gltf en .glb ne le convertit pas. Exportez un binaire glTF avec des tampons et des images intégrés. Ce service rejette les références externes, y compris les URI de données, et valide la structure GLB avant le traitement.

Draco ou une extension requise non prise en charge

Réexportez depuis votre outil de création d'origine sans compression Draco. Si une extension requise n'est pas prise en charge, utilisez un chemin d'exportation qui préserve l'apparence sans elle. Supprimer son nom de la liste des extensions du fichier ne rend pas les données compatibles.

Le résultat est plus grand

Les entrées déjà compactes ne rétrécissent pas toujours. Essayez un fichier plus petit si votre destination prend en charge Meshopt. Si les textures dominent, testez KTX2 ou WebP et une taille de texture maximale inférieure. Comparez la qualité visuelle et la compatibilité ainsi que les octets ; conserver l’original lorsque le compromis n’est pas utile.

Les textures sont manquantes ou la sortie ne se chargera pas

Essayez d’abord de conserver le format de texture d’origine. Si cela fonctionne, vérifiez la prise en charge KTX2 ou WebP de votre destination. Pour la sortie Meshopt, vérifiez la configuration du décodeur. Une erreur d'aperçu du navigateur peut également refléter les limites de l'appareil ; testez le modèle original dans votre application cible et lisez le guide de compatibilité.

Le modèle est différent

Redéfinissez la cible du triangle sur 100%, conservez les textures d'origine et activez les boutons de préservation. Inspectez séparément la géométrie, la transparence, les matériaux et l’animation. Même ces paramètres permettent des modifications d'optimisation. Si votre application dépend de métadonnées ou d'une structure exacte non prises en charge, conservez l'original ou évaluez des options de moteur local plus spécifiques.

Le traitement s'arrête ou la file d'attente est indisponible

Les limites actuelles sont de 50 Mo par téléchargement, 100 Mo par sortie et 120 secondes par tentative de traitement. Les tampons décodés déclarés sont limités à 256 Mio ; la taille du fichier compressé à elle seule ne prédit pas l’utilisation de la mémoire. Essayez des textures moins nombreuses ou plus petites, désactivez la conversion de texture ou exécutez le moteur natif localement.

Une file d'attente pleine ou un travailleur indisponible est temporaire. Réessayez plus tard. Une réponse de limite de débit signifie que vous devez attendre avant d'envoyer d'autres téléchargements.

Le téléchargement a expiré

Les résultats expirent 60 minutes après le téléchargement, y compris le temps de file d'attente et de traitement. Téléchargez rapidement à partir de la page de tâche d'origine. Si la tâche expire ou si son jeton d'accès est perdu, téléchargez à nouveau l'original. Le service est un traitement temporaire et non un stockage de fichiers.

Réduction de polygones GLB avec gltfpack →

Pourquoi un GLB s'agrandit après optimisation →