WebGL2 no disponible? Resolución por plataforma para la vista previa 3D

Síntomas que observas

El área de vista previa muestra "Vista previa 3D no disponible", o la página está en blanco y no se muestra el modelo. La vista previa en línea de Any3D depende de WebGL2 para renderizar escenas 3D en la GPU; cuando WebGL2 no está disponible, la vista previa no puede iniciarse.

Causas comunes

Causa	Escenario típico
Aceleración de hardware deshabilitada	El navegador o la configuración del sistema desactivan la GPU
Controlador de GPU obsoleto/anómalo	Portátiles con GPU dual en Windows, controladores de código abierto en Linux
Lista negra del navegador	GPUs muy antiguas enlistadas para renderizado por software
Escritorio remoto / Máquina virtual	RDP/VM sin passthrough de GPU
Políticas empresariales	GPO que deshabilita aceleración por hardware, VDI sin aceleración 3D
WebView / Kernel antiguo	WeChat, DingTalk, apps antiguas
Extensión que interfiere	Plugins de protección contra huella Canvas

Resolución por plataforma

Windows

1. Habilitar aceleración de hardware Chrome/Edge: Configuración → Sistema → "Usar aceleración de hardware (si está disponible)" → Reiniciar el navegador.

2. Actualizar controlador de GPU Instalar el controlador más reciente desde el sitio oficial de NVIDIA/AMD/Intel o Windows Update. En portátiles, configurar el navegador como "alto rendimiento" en el panel de control de la GPU.

3. Directiva de grupo / Registro (empresa) IT podría deshabilitar la composición por GPU mediante políticas. Los usuarios individuales pueden verificar en chrome://gpu si hay muchos "Software only".

4. Escritorio remoto Al conectar por RDP a una máquina de oficina, WebGL suele estar no disponible: abre Any3D en el navegador de tu PC local o usa una solución remota con soporte GPU.

5. Controles parentales Las subcuentas de Microsoft Family Safety generalmente no deshabilitan WebGL; si usas un "navegador infantil" de terceros, prueba con Chrome/Edge.

macOS

1. Safari o Chrome actualizados; Configuración del Sistema → Pantallas → Tasa de refresco/resolución normales.
2. Modo de bajo consumo reduce la frecuencia de la GPU, lo que puede afectar WebGL en casos extremos: conéctate a la energía y vuelve a intentar.
3. Tiempo de pantalla no deshabilita WebGL directamente; si un MDM restringe gráficos, contacta a IT.

Linux

1. Controlador propietario (NVIDIA) o Mesa actualizado; verifica el estado GL en chrome://gpu.
2. Si falla en Wayland o X11, intenta cambiar de sesión para comparar.

iOS / iPadOS

1. Safari tiene buen soporte para WebGL2; mantén el sistema actualizado.
2. Modo de bajo consumo puede limitar el rendimiento, causando fallos o lentitud en la vista previa: carga el dispositivo y vuelve a intentar.
3. En WebView dentro de apps → Abrir en Safari.
4. iPads escolares supervisados: si restringen "cámara/archivos" no afecta WebGL, pero si bloquean actualizaciones del sistema, el kernel quedará obsoleto.

Android

1. Actualiza Chrome; habilita Opciones de desarrollador → Renderizado forzado por GPU (efectivo en algunos modelos antiguos, los sistemas nuevos suelen tenerlo por defecto).
2. Navegadores nacionales con núcleo de compatibilidad a menudo no soportan WebGL2 → usa Chrome.
3. Modo de ahorro de energía limita la GPU: desactívalo y vuelve a intentar.

Red, VPN e intranet empresarial

WebGL2 es una API local de GPU y generalmente no se ve afectada directamente por VPN, pero ten en cuenta los siguientes escenarios:

Escenario	Descripción
VDI empresarial (Citrix/VMware)	Si no está habilitado el passthrough de GPU, WebGL no estará disponible. IT debe habilitar vGPU o usar el navegador local
VPN que instala extensiones forzadas en el navegador	Las extensiones pueden interferir con el contexto WebGL
Intranet que solo permite IE/Edge antiguo	No soporta WebGL2; es necesario usar un navegador Chromium moderno

Controles parentales y entornos públicos

• PCs de biblioteca/escuela: podrían usar un navegador bloqueado o sin GPU dedicada. Prueba con tu portátil personal.
• Family Link que restringe la versión de Chrome: permite la actualización desde Play Store.

Solución paso a paso (general)

1. Abre chrome://gpu (Chrome/Edge) o about:support → Gráficos, y verifica si WebGL2 está acelerado por hardware.
2. Habilita la aceleración de hardware, actualiza los controladores y reinicia el navegador y el sistema.
3. Usa una ventana de incógnito para descartar extensiones.
4. Cambia de navegador o dispositivo para una verificación cruzada.

Autoverificación rápida

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

Si retorna false, significa que no se puede crear el contexto WebGL2.

También puedes acceder a WebGL Report (requiere acceso a internet externo) para ver capacidades detalladas.

Relación con OffscreenCanvas

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

Conclusión

La indisponibilidad de WebGL2 se debe principalmente a problemas de GPU/controlador/aceleración de hardware. VDI empresarial, escritorios remotos y WebView antiguos también son causas comunes. Habilita la aceleración por plataforma, actualiza controladores y accede desde el navegador local para recuperar la vista previa 3D en la mayoría de los casos.