WebGL2 indisponível? Solução de problemas de pré-visualização 3D por plataforma

O que você está vendo

A área de pré-visualização mostra "Pré-visualização 3D indisponível", ou a página fica em branco, sem exibição do modelo. A pré-visualização online do Any3D depende do WebGL2 para renderizar cenas 3D na GPU; quando o WebGL2 não está disponível, a pré-visualização não inicia.

Causas comuns

Causa	Cenário típico
Aceleração de hardware desativada	GPU desabilitada nas configurações do navegador ou sistema
Driver de GPU desatualizado/com problema	Notebooks Windows com GPU dupla, drivers open-source no Linux
Lista negra do navegador	GPUs muito antigas colocadas na lista de renderização por software
Área de trabalho remota / VM	RDP, VM sem passagem de GPU
Política corporativa	GPO desabilita aceleração de hardware, VDI sem aceleração 3D
WebView / kernel antigo	WhatsApp Web, apps antigos, visualizadores embutidos
Interferência de extensões	Plugins de proteção de fingerprint de Canvas

Solução por plataforma

Windows

1. Ative a aceleração de hardware
   Chrome/Edge: Configurações → Sistema → "Usar aceleração de hardware quando disponível" → reinicie o navegador.

2. Atualize o driver da GPU
   Instale o driver mais recente pelo site da NVIDIA / AMD / Intel ou pelo Windows Update. Em notebooks, defina o navegador como "Alto desempenho" no painel de controle da GPU.

3. Política de grupo / Registro (empresas)
   A TI pode desabilitar a composição por GPU via política. Usuários domésticos podem verificar em chrome://gpu se há muitos itens "Somente software".

4. Área de trabalho remota
   Ao usar RDP para um PC do trabalho, o WebGL geralmente não funciona — abra o Any3D no navegador do seu PC local ou use uma solução remota com suporte a GPU.

5. Controle parental
   Contas de criança no Windows Family Safety geralmente não bloqueiam WebGL; se usar um "navegador infantil" de terceiros, teste com Chrome/Edge.

macOS

1. Safari / Chrome na versão mais recente; Ajustes do Sistema → Monitores → taxa de atualização/resolução normais são suficientes.
2. No Modo de Baixo Consumo, a GPU é reduzida, o que pode afetar o WebGL em casos extremos — conecte na tomada e tente novamente.
3. Tempo de Uso não bloqueia WebGL diretamente; se houver restrições gráficas via MDM, contate a TI.

Linux

1. Drivers proprietários (NVIDIA) ou Mesa mais recente; verifique o status GL em chrome://gpu.
2. Se Wayland falhar, tente alternar para X11 (ou vice-versa) e compare.

iOS / iPadOS

1. Safari tem bom suporte a WebGL2; mantenha o sistema atualizado.
2. Modo de Baixo Consumo pode limitar o desempenho, causando lentidão ou falha na pré-visualização — carregue e tente novamente.
3. WebView dentro de apps → abra no Safari.
4. iPads gerenciados pela escola que bloqueiam "Câmera/Arquivos" não afetam o WebGL, mas bloquear atualizações do sistema pode deixar o kernel desatualizado.

Android

1. Atualize o Chrome; ative Opções do desenvolvedor → Forçar renderização por GPU (funciona em alguns aparelhos antigos; em sistemas novos pode já estar ativo).
2. Navegadores nacionais com kernel de compatibilidade geralmente não têm WebGL2 → use o Chrome.
3. Modo de economia de energia limita a GPU — desative e tente novamente.

Rede, VPN e intranet corporativa

O WebGL2 é uma API local de GPU, normalmente não é afetado diretamente por VPN. Mas fique atento aos seguintes casos:

Cenário	Descrição
VDI corporativo (Citrix/VMware)	Sem passagem de GPU, o WebGL não funciona; peça à TI para ativar vGPU ou use navegador local
VPN que instala extensões no navegador	Extensões podem interferir no contexto WebGL
Intranet que só permite IE/Edge antigo	Sem WebGL2; é necessário usar um navegador Chromium moderno

Controle parental e ambientes públicos

• PCs de bibliotecas/escolas: podem usar navegadores bloqueados ou sem GPU dedicada — teste em um notebook pessoal.
• Family Link limitando a versão do Chrome: permita atualizações do Chrome pela Play Store.

Correção passo a passo (geral)

1. Abra chrome://gpu (Chrome/Edge) ou about:support → Gráficos, e verifique se o WebGL2 está como Hardware accelerated.
2. Ative a aceleração de hardware, atualize os drivers, reinicie o navegador e o sistema.
3. Use uma janela anônima para descartar extensões.
4. Troque de navegador / dispositivo para teste cruzado.

Autoteste rápido

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

Retornar false significa que não foi possível criar um contexto WebGL2.

Você também pode visitar o WebGL Report (requer acesso à internet) para ver os recursos detalhados.

Relação com OffscreenCanvas

O caminho do Worker de compressão de texturas também precisa de OffscreenCanvas + WebGL2. Se apenas o aviso amarelo do Worker aparecer na parte inferior e a pré-visualização estiver normal, consulte primeiro o Guia de OffscreenCanvas; se a pré-visualização em si falhar, este artigo é o principal.

Resumo

O problema de WebGL2 indisponível é essencialmente uma questão de GPU/driver/aceleração de hardware; VDI corporativo, área de trabalho remota e WebViews antigos também são comuns. Ative a aceleração por plataforma, atualize os drivers e acesse pelo navegador local — na maioria dos casos, a pré-visualização 3D volta a funcionar.