WebGPU indisponível? Diagnóstico por plataforma e ambiente
O que você está vendo
O Any3D ou a detecção de ambiente do navegador indica que o WebGPU está indisponível. Ou seja: navigator.gpu não existe ou não foi possível obter o adaptador (adapter) de GPU.
Importante: o Any3D atualmente usa WebGL2 como base para a pré-visualização 3D; a ausência do WebGPU não bloqueia, sozinha, o fluxo principal de pré-visualização e conversão. Este artigo serve para diagnóstico completo do ambiente e referência futura. Se a pré-visualização falhar, consulte primeiro o guia de correção do WebGL2.
O que é WebGPU
WebGPU é a próxima geração de API gráfica/computacional do navegador. Chrome, Edge, Safari etc. estão habilitando gradualmente por padrão. O Any3D detecta e reporta a capacidade do WebGPU para diagnóstico; alguns recursos experimentais podem depender dele no futuro.
Causas comuns
| Causa | Cenário típico |
|---|---|
| Navegador sem WebGPU habilitado | Chrome < 113 precisa de flag manual; Safari antigo |
| Sistema operacional incompatível | Builds antigas do Windows 10, macOS/iOS desatualizados |
| Driver de GPU desatualizado | Especialmente Intel integrada, Mesa Linux antigo |
| Política corporativa/experimental desabilitada | WebGPU ou "recursos gráficos experimentais" bloqueados |
| Máquina virtual / RDP | Sem virtualização de GPU |
| Extensões ou ferramentas de privacidade | Interceptam navigator.gpu (raro) |
Diagnóstico por plataforma
Windows
- Chrome 113+ / Edge 113+: abra
chrome://gpuna barra de endereços e confirme se o status do WebGPU é Hardware accelerated ou Available. - Versões antigas precisam de
chrome://flags/#enable-unsafe-webgpu(na maioria das versões novas já é padrão, sem necessidade de ativar manualmente). - Atualize o Windows 10/11 e o driver da placa de vídeo; o WebGPU depende de uma stack DXGI/D3D12 mais recente.
- Política de grupo: empresas podem desabilitar "recursos experimentais da plataforma web".
- RDP / Hyper-V: normalmente sem WebGPU; teste em máquina física local.
macOS
- Safari 17+ (macOS Sonoma+) ou Chrome na versão mais recente.
- Apple Silicon tem bom suporte; Macs com Intel precisam de macOS e drivers mais novos.
- Restrições de MDM em "recursos Beta" podem afetar o interruptor experimental do WebGPU.
Linux
- Chrome recente + Mesa 22+ ou driver NVIDIA 525+.
- Suporte a Vulkan é um pré-requisito comum:
vulkaninfopode verificar rapidamente (usuários avançados).
iOS / iPadOS
- Safari 17+ (iOS 17+) tem suporte a WebGPU em evolução gradual.
- O sistema precisa estar atualizado; dispositivos gerenciados podem ter atualizações atrasadas pelo administrador.
- Chrome no iOS usa WebKit, com as mesmas capacidades do Safari.
Android
- Chrome 121+ tem WebGPU por padrão em alguns dispositivos; aparelhos de entrada podem continuar sem suporte.
- Atualize o Chrome e o WebView do sistema; GPUs muito antigas fazem o navegador degradar silenciosamente.
Rede, VPN e intranet corporativa
WebGPU é uma API local e não é bloqueada diretamente por VPN. Casos indiretos:
| Cenário | Explicação |
|---|---|
| Imagem corporativa do navegador | Chromium customizado pode ter WebGPU desabilitado na compilação |
| Intranet só permite Edge antigo | Sem WebGPU; precisa que a TI atualize a versão |
| Cliente zero trust | Raramente modifica navigator.gpu; se suspeitar, compare no modo anônimo |
Controle parental e supervisão
- Bloqueio de atualização do sistema/navegador → WebGPU fica indisponível por muito tempo; permitir atualizações automáticas resolve.
- Perfil infantil normalmente não bloqueia WebGPU; se usar navegador minimalista, troque para Chrome/Safari.
Correção passo a passo (geral)
- Atualize sistema operacional + navegador + driver de GPU.
- Veja
chrome://gpupara o item WebGPU; atualize ou habilite conforme indicado. - Rode em máquina física local, não RDP/VDI.
- Use janela anônima para descartar extensões.
Teste rápido
typeof navigator.gpu !== "undefined";
Detecção assíncrona do adaptador (Console):
navigator.gpu?.requestAdapter().then((a) => console.log(a ? "adapter ok" : "no adapter"));
no adapter é comum com driver antigo, máquina virtual ou GPU sem suporte.
Relação com os recursos do Any3D
| Recurso | Quando WebGPU está ausente |
|---|---|
| Pré-visualização 3D (WebGL2) | Geralmente não afetado |
| Conversão de formatos / compressão WASM | Não afetado |
| Recursos futuros acelerados por WebGPU | Pode ficar indisponível |
Resumo
WebGPU indisponível geralmente significa sistema/navegador/driver desatualizado, máquina virtual ou navegador antigo bloqueado por política corporativa. As funções principais do Any3D dependem de WebGL2 e WASM; se houver apenas o aviso de WebGPU e a ferramenta funcionar normalmente, não é necessário agir agora, mas é recomendável manter sistema e navegador atualizados para melhor desempenho no futuro.