WebGL2 indisponible ? Dépannage de l'aperçu 3D par plateforme

Symptômes observés

La zone d'aperçu affiche « Aperçu 3D indisponible », ou la page reste blanche sans affichage du modèle. L'aperçu en ligne d'Any3D repose sur WebGL2 pour le rendu 3D via le GPU ; si WebGL2 est indisponible, l'aperçu ne peut pas démarrer.

Causes fréquentes

Cause	Scénario typique
Accélération matérielle désactivée	Navigateur ou système désactive le GPU
Pilotes graphiques obsolètes/défectueux	Ordinateur portable Windows avec double GPU, pilotes open source Linux
Navigateur sur liste noire	GPU très ancien mis en liste de rendu logiciel par le navigateur
Bureau à distance / machine virtuelle	RDP, VM sans passthrough GPU
Stratégie d'entreprise	GPO désactive l'accélération matérielle, VDI sans accélération 3D
WebView / noyau ancien	WhatsApp, Teams, anciennes applications
Interférence d'extension	Extensions de protection contre les empreintes Canvas forcées

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 les pilotes graphiques
   Téléchargez les derniers pilotes depuis le site officiel de NVIDIA / AMD / Intel ou via Windows Update. Sur un ordinateur portable, définissez le navigateur comme « Haute performance » dans le panneau de configuration graphique.

3. Stratégie de groupe / Registre (entreprise)
   L'informatique peut avoir désactivé la composition GPU via une stratégie. Les utilisateurs personnels peuvent vérifier chrome://gpu pour voir si de nombreux éléments sont « Software only ».

4. Bureau à distance
   RDP vers un ordinateur de bureau : WebGL est souvent indisponible – ouvrez Any3D dans le navigateur de votre PC local ou utilisez une solution de bureau à distance prenant en charge le GPU.

5. Contrôle parental
   Les comptes enfants de Windows Family Safety ne bloquent généralement pas WebGL ; si vous utilisez un « navigateur pour enfants » tiers, testez avec Chrome/Edge.

macOS

1. Dernière version de Safari / Chrome ; Paramètres système → Moniteurs → Vérifiez que la fréquence de rafraîchissement/résolution est normale.
2. Le mode basse consommation réduit les performances du GPU, ce qui peut affecter WebGL dans les cas extrêmes – branchez l'alimentation et réessayez.
3. Temps d'écran ne bloque pas directement WebGL ; si une restriction MDM limite les graphiques, contactez l'informatique.

Linux

1. Pilotes propriétaires (NVIDIA) ou Mesa récent ; vérifiez l'état GL dans chrome://gpu.
2. Si Wayland échoue, essayez X11, ou vice versa.

iOS / iPadOS

1. Safari prend bien en charge WebGL2 ; maintenez le système à jour.
2. Le mode basse consommation peut limiter les performances, l'aperçu peut être lent ou échouer – rechargez après avoir branché l'alimentation.
3. WebView dans une application → Ouvrir dans Safari.
4. Les iPad sous contrôle scolaire peuvent interdire « Appareil photo/Fichiers » sans affecter WebGL, mais le blocage des mises à jour système peut entraîner un noyau trop ancien.

Android

1. Mettez à jour Chrome ; activez Options développeur → Forcer le rendu GPU (efficace sur certains anciens modèles, peut être déjà par défaut sur les systèmes récents).
2. Les navigateurs chinois 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 GPU locale, généralement non affectée directement par le VPN. Cependant, les situations suivantes nécessitent une attention particulière :

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

Contrôle parental et environnement public

• PC de bibliothèque/école : peut utiliser un navigateur verrouillé ou un GPU intégré – testez sur votre ordinateur portable personnel.
• Family Link limite la version de Chrome : autorisez les mises à jour via le Play Store.

Réparation étape par étape (générique)

1. Ouvrez chrome://gpu (Chrome/Edge) ou about:support → Graphiques, vérifiez que WebGL2 est Hardware accelerated.
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 de navigation privée pour exclure les extensions.
4. Testez avec un autre navigateur / un autre appareil pour une vérification croisée.

Auto-test rapide

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

Un retour false signifie qu'aucun contexte WebGL2 ne peut être créé.

Vous pouvez également consulter WebGL Report (accessible depuis l'extérieur) pour des capacités détaillées.

Relation avec OffscreenCanvas

Le chemin du Worker de compression de texture nécessite également OffscreenCanvas + WebGL2. Si vous voyez uniquement un avertissement Worker jaune en bas de page alors que l'aperçu fonctionne, consultez d'abord le guide OffscreenCanvas ; si l'aperçu lui-même échoue, concentrez-vous sur cet article.

Résumé

L'indisponibilité de WebGL2 est principalement un problème de GPU/pilote/accélération matérielle, souvent rencontré également dans les VDI d'entreprise, les bureaux à distance et les anciens WebView. En activant l'accélération par plateforme, en mettant à jour les pilotes et en utilisant un navigateur local, l'aperçu 3D peut généralement être rétabli.