¿WebGL2 no disponible? Solución de problemas de vista previa 3D por plataforma

Síntomas que puedes ver

El área de vista previa muestra el mensaje «Vista previa 3D no disponible», o la página aparece en blanco sin ningún modelo. La vista previa en línea de Any3D depende de WebGL2 para renderizar escenas 3D en la GPU; si WebGL2 no está disponible, la vista previa no se iniciará.

Causas comunes

Causa	Escenario típico
Aceleración por hardware desactivada	El navegador o el sistema tiene deshabilitada la GPU
Controladores de GPU obsoletos o defectuosos	Portátil con doble GPU en Windows, controladores de código abierto en Linux
Lista negra del navegador	GPU muy antigua incluida en la lista de renderizado por software del navegador
Escritorio remoto / Máquina virtual	RDP, VM sin paso de GPU
Políticas empresariales	GPO que deshabilita la aceleración por hardware, VDI sin aceleración 3D
WebView / kernel antiguo	WhatsApp, Teams, Telegram, aplicaciones antiguas
Extensiones conflictivas	Extensiones de protección de huella digital de Canvas forzadas

Solución de problemas por plataforma

Windows

1. Activar la aceleración por hardware
   Chrome/Edge: Ajustes → Sistema → «Usar aceleración de hardware cuando esté disponible» → Reiniciar el navegador.

2. Actualizar los controladores de la GPU
   Descarga los controladores más recientes desde la web oficial de NVIDIA / AMD / Intel o mediante Windows Update. En portátiles, configura el navegador como «Alto rendimiento» en el panel de control de la GPU.

3. Directiva de grupo / Registro (entorno empresarial)
   El departamento de TI puede haber deshabilitado la composición por GPU mediante directivas. Los usuarios particulares pueden comprobar en chrome://gpu si aparece «Solo software» en muchas entradas.

4. Escritorio remoto
   Al conectarte por RDP a un equipo de oficina, WebGL suele no estar disponible. Abre Any3D en el navegador del PC local o utiliza una solución remota compatible con GPU.

5. Control parental
   Las cuentas de hijo de Microsoft Family Safety no suelen bloquear WebGL; si usas un «navegador infantil» de terceros, prueba con Chrome/Edge.

macOS

1. Safari / Chrome en su última versión; Ajustes del sistema → Pantalla → la frecuencia de refresco/resolución normal basta.
2. El modo de bajo consumo reduce la frecuencia de la GPU, lo que en casos extremos puede afectar a WebGL: enchufa el cargador y vuelve a intentarlo.
3. Tiempo de uso no bloquea WebGL directamente; si hay restricciones gráficas mediante MDM, contacta con el departamento de TI.

Linux

1. Controladores propietarios (NVIDIA) o Mesa reciente; consulta chrome://gpu para ver el estado de GL.
2. Si Wayland o X11 falla, prueba cambiando de sesión para comparar.

iOS / iPadOS

1. Safari tiene buena compatibilidad con WebGL2; mantén el sistema actualizado.
2. Modo de bajo consumo puede limitar el rendimiento, provocando que la vista previa se ralentice o falle; carga el dispositivo y vuelve a intentarlo.
3. WebView dentro de aplicaciones → abre en Safari.
4. Los iPads gestionados por centros educativos pueden bloquear «Cámara/Archivos» sin afectar a WebGL, pero si se impide la actualización del sistema, el kernel quedará obsoleto.

Android

1. Actualiza Chrome; activa Opciones de desarrollador → Forzar renderizado por GPU (funciona en algunos modelos antiguos; en sistemas nuevos suele estar activado por defecto).
2. Algunos navegadores de terceros pueden no tener soporte completo de WebGL2; usa Chrome.
3. El modo de ahorro de energía limita la GPU; desactívalo y vuelve a intentar.

Red, VPN e intranet empresarial

WebGL2 es una API de GPU local, por lo que normalmente no se ve afectada directamente por la VPN. Sin embargo, ten en cuenta los siguientes casos:

Escenario	Descripción
VDI empresarial (Citrix/VMware)	Sin paso de GPU, WebGL no estará disponible; el departamento de TI debe habilitar vGPU o usar el navegador local
La VPN fuerza la instalación de extensiones del navegador	Las extensiones pueden interferir con el contexto de WebGL
La intranet solo permite IE / Edge antiguo	No tienen WebGL2; es necesario usar un navegador Chromium moderno

Control parental y entornos públicos

• PC de biblioteca/colegio: pueden usar navegadores bloqueados o sin GPU discreta; prueba con tu portátil personal.
• Family Link limita la versión de Chrome: permite actualizar Chrome desde Play Store.

Reparación paso a paso (general)

1. Abre chrome://gpu (Chrome/Edge) o about:support → Gráficos, y comprueba si WebGL2 aparece como Hardware accelerated.
2. Activa la aceleración por hardware, actualiza los controladores, reinicia el navegador y el sistema.
3. Abre una ventana de incógnito para descartar extensiones.
4. Cambia de navegador / dispositivo para verificarlo de forma cruzada.

Autocomprobación rápida

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

Si devuelve false, significa que no se puede crear un contexto WebGL2.

También puedes visitar WebGL Report (necesita acceso a Internet) para ver las capacidades detalladas.

Relación con OffscreenCanvas

La ruta del Worker de compresión de texturas también necesita OffscreenCanvas + WebGL2. Si solo aparece la advertencia amarilla del Worker (parte inferior) pero la vista previa funciona correctamente, consulta primero la guía de OffscreenCanvas; si la vista previa falla, prioriza este artículo.

Resumen

La falta de WebGL2 suele deberse a problemas de GPU/controladores/aceleración por hardware, y también es común en VDI empresarial, escritorio remoto y WebView antiguo. Siguiendo las indicaciones para cada plataforma (activar aceleración, actualizar controladores, usar el navegador local), la mayoría de los casos de vista previa 3D se pueden resolver.