WebGL2 indisponible ? Dépannage 3D par plateforme

Symptômes observés

La zone d'aperçu affiche « Aperçu 3D non disponible », ou la page reste vide sans modèle affiché. L'aperçu en ligne d'Any3D repose sur WebGL2 pour rendre les scènes 3D sur le GPU ; si WebGL2 est indisponible, l'aperçu ne démarre pas.

Causes courantes

Cause	Scénario typique
Accélération matérielle désactivée	Le navigateur ou le système désactive le GPU
Pilote graphique ancien/défectueux	PC portables Windows avec double GPU, pilotes open-source sous Linux
Liste noire du navigateur	GPU très ancien placé en mode de rendu logiciel
Bureau à distance / Machine virtuelle	RDP, VM sans passthrough GPU
Politiques d'entreprise	GPO désactivant l'accélération matérielle, VDI sans accélération 3D
WebView / Noyau ancien	WeChat, DingTalk, anciennes applications
Interférence d'extensions	Extensions de protection par empreinte Canvas

Dépannage par plateforme

Windows

1. Activer l'accélération matérielle Chrome/Edge : Paramètres → Système → « Utiliser l'accélération matérielle (si disponible) » → Redémarrer le navigateur.

2. Mettre à jour le pilote graphique Installer le dernier pilote depuis le site NVIDIA / AMD / Intel ou via Windows Update. Sur les ordinateurs portables, définir le navigateur en mode « Haute performance » dans le panneau de contrôle du GPU.

3. Stratégie de groupe / Registre (entreprise) L'informatique peut désactiver la composition GPU via une stratégie. Les utilisateurs individuels peuvent vérifier chrome://gpu pour voir de nombreuses mentions « Software only ».

4. Bureau à distance En connexion RDP vers un poste de travail, WebGL est souvent indisponible — ouvrez Any3D dans le navigateur du PC local, ou utilisez une solution distante prenant en charge le GPU.

5. Contrôle parental Les sous-comptes Family Safety sous Windows ne désactivent généralement pas WebGL ; si vous utilisez un « navigateur pour enfants » tiers, essayez Chrome/Edge.

macOS

1. Utiliser la dernière version de Safari / Chrome ; Système → Affichage → Vérifier que la fréquence de rafraîchissement/résolution est normale.
2. Le mode Économie d’énergie réduit la fréquence du GPU, pouvant affecter WebGL dans des cas extrêmes — rebranchez l’alimentation et réessayez.
3. Le Temps d’écran ne désactive pas WebGL ; si une restriction MDM s’applique aux graphismes, contactez l’informatique.

Linux

1. Utiliser des pilotes propriétaires (NVIDIA) ou une version récente de Mesa ; vérifier l’état GL via chrome://gpu.
2. Si Wayland échoue, essayez une session X11, et inversement.

iOS / iPadOS

1. Safari prend bien en charge WebGL2 ; maintenez le système à jour.
2. Le mode Économie d’énergie peut limiter les performances, rendant l’aperçu lent ou défaillant — rechargez et réessayez.
3. Dans une application WebView → Ouvrir dans Safari.
4. Un iPad supervisé par une école peut interdire « Caméra/Fichiers » sans affecter WebGL, mais empêcher les mises à jour système entraîne un noyau obsolète.

Android

1. Mettez à jour Chrome ; activez Options pour développeurs → Rendu GPU forcé (efficace sur certains anciens appareils, peut déjà être activé par défaut sur les nouveaux systèmes).
2. Les navigateurs chinois avec noyau de compatibilité n’ont souvent pas WebGL2 → utilisez Chrome.
3. Le mode Économie d’énergie limite le GPU — désactivez-le et réessayez.

Réseau, VPN et réseau interne d'entreprise

WebGL2 est une API locale du GPU, généralement non affectée par le VPN. Toutefois, les cas suivants nécessitent une attention :

Scénario	Explication
VDI d’entreprise (Citrix/VMware)	Si le passthrough GPU n’est pas activé, WebGL est indisponible — l’informatique doit activer vGPU ou utiliser un navigateur local
VPN forçant l’installation d’extensions navigateur	Ces extensions peuvent interférer avec le contexte WebGL
Réseau interne autorisant uniquement IE/ancien Edge	Pas de WebGL2, il faut utiliser un navigateur Chromium moderne

Contrôle parental et environnements publics

• PC de bibliothèque/école : peuvent utiliser des navigateurs verrouillés sans GPU dédié — vérifiez avec votre propre ordinateur portable.
• Restrictions Family Link sur Chrome : autorisez les mises à jour de Chrome via le Play Store.

Correction pas à pas (général)

1. Ouvrez chrome://gpu (Chrome/Edge) ou about:support → Graphisme pour vérifier si WebGL2 est en Accélération matérielle.
2. Activez l’accélération matérielle, mettez à jour les pilotes, redémarrez le navigateur et le système.
3. Utilisez une fenêtre sans historique pour exclure les extensions.
4. Testez avec un autre navigateur / un autre appareil pour croiser les résultats.

Auto-test rapide

(() => {
  const c = document.createElement("canvas");
  return c.getContext("webgl2") !== null;
})()

Retourne false si le contexte WebGL2 ne peut pas être créé.

Vous pouvez également consulter WebGL Report (nécessitant un accès Internet) pour des détails sur les capacités.

Lien avec OffscreenCanvas

Le chemin Worker de compression des textures nécessite également OffscreenCanvas + WebGL2. Si seule l’alerte jaune du Worker apparaît en bas mais que l’aperçu fonctionne, consultez d’abord le Guide OffscreenCanvas ; si l’aperçu échoue lui-même, suivez cet article.

Conclusion

L’indisponibilité de WebGL2 est principalement liée au GPU/pilote/accélération matérielle. Les VDI d’entreprise, les bureaux à distance et les anciennes WebView sont également fréquents. En activant l’accélération par plateforme, en mettant à jour les pilotes et en accédant via un navigateur local, la plupart des aperçus 3D peuvent être restaurés.