Moteur et API
Diagnostiquer chargement, rendu et performances
Utilisez les diagnostics et une séquence reproductible pour isoler les problèmes d’hôte, média, rendu, état ou permissions.
Vue d’ensemble du guide
Avant de commencer
- Le problème est reproductible sur un hôte proche de la production.
- Les outils développeur du navigateur sont disponibles.
- La version et l’identifiant produit sont connus.
Résultat attendu
Un rapport de diagnostic exploitable identifie l’étape en échec sans exposer de secrets ni de données client.
Classer la panne
Conteneur absent, bundle échoué, état rejeté, média inaccessible, WebGL indisponible et permission masquée peuvent tous ressembler à un designer vide. Vérifiez dans cet ordre avant de modifier le produit.
Notez si le problème touche tous les produits, une vue, un fichier, un navigateur ou un rôle.
Contrôler les dimensions du conteneur.
Vérifier bundles et état.
Inspecter médias et CORS.
Comparer les permissions admin et client.
Mesurer le coût du rendu
Utilisez réseau, outils de performance et diagnostics pour trouver images, GLB, textures ou mises à jour trop lourdes. Le moteur 3D et le modèle ne doivent charger qu’à l’ouverture d’une vue 3D.
Ne recréez pas le designer pour un changement d’état ordinaire. Temporisez persistance et prix, puis libérez les instances fermées.
Mesurer le premier rendu utile.
Lister les plus gros assets.
Changer de vue en observant la mémoire.
Chercher événements et requêtes en double.
Préparer un rapport utile
Joignez type d’intégration, versions, identifiants produit et vue, navigateur, action, erreur assainie et statut réseau. N’incluez jamais clés, headers d’autorisation, coordonnées client ou contenu privé.
Reproduisez avec le plus petit produit encore en échec et précisez résultat attendu et obtenu.
Exporter les diagnostics assainis.
Ajouter les étapes exactes.
Joindre une capture pertinente.
Vérifier l’absence de secrets.