Any3DAny3D
·Any3D Team

¿Web Worker no disponible? Solución por plataforma y entorno

troubleshootingbrowser-compatibilityweb-worker

Síntomas que ves

Any3D muestra un aviso amarillo en la parte inferior: "Tu navegador actual no admite Web Worker". La vista previa puede seguir funcionando, pero el procesamiento de archivos grandes puede bloquear la página; las rutas de Worker para compresión de texturas y conversión de imágenes a modelos no se activarán.

Web Worker permite ejecutar cálculos largos en un hilo en segundo plano. El proceso de compresión de texturas y algunas conversiones en Any3D dependen del trío: Worker + OffscreenCanvas + createImageBitmap.

Causas comunes

CausaEscenario típico
Contexto no seguroAbrir con file://, intranet HTTP (no localhost)
Navegador anticuado / WebViewNavegador antiguo del sistema, páginas incrustadas en apps
Restricción CSPiframe de portal corporativo, cliente de confianza cero inyecta worker-src
Bloqueo por extensionesPlugin de privacidad que bloquea Worker o URL blob:
Error de caché de redProxy/VPN devuelve scripts de Worker incompletos
Supervisión del dispositivoPerfiles administrados deshabilitan scripts en segundo plano

Solución por plataforma

Windows

  1. Debe acceder por HTTPS (https://any3d.cc); no use archivos HTML locales.
  2. Directivas de empresa Edge: Revise en Configuración del equipo → Plantillas administrativas → Microsoft Edge si hay restricciones sobre Worker o cookies de terceros (afectan indirectamente la carga de algunos Worker).
  3. Seguridad familiar de Windows: Las restricciones web en subcuentas pueden impedir la creación de Worker.

macOS

  1. Safari / Chrome requieren macOS 12+ y versiones recientes del navegador.
  2. Tiempo de pantalla → Contenido y privacidad: si está activada la opción "Restringir sitios web para adultos" o un filtro personalizado, podría bloquear erróneamente los dominios de los scripts de Worker.
  3. Si el perfil MDM corporativo deshabilita capacidades de scripts fuera de "rastreo entre sitios", contacte a IT.

Linux

  1. Verifique que la URL de acceso sea HTTPS; el proxy corporativo Squid debe permitir solicitudes relacionadas con blob: y worker-src.

iOS / Android

  1. No use el navegador integrado de WeChat/DingTalk para procesar archivos grandes; ábralo con el navegador del sistema.
  2. El modo de bajo consumo de iOS generalmente no deshabilita Worker, pero versiones antiguas de WebKit pueden carecer de la API — mantenga el sistema actualizado.
  3. Una versión de WebView de Android anticuada (WebView del sistema sin actualizar) causará que Worker no esté disponible: actualice "Android System WebView" desde la Play Store.

Red, VPN e intranet corporativa

EscenarioExplicación
VPN corporativaAlgunas VPN fuerzan la decodificación HTTPS e inyectan CSP; es necesario que IT permita Worker
Portal SSO intranet en iframeLa CSP de la página externa puede prohibir worker-src blob:; configure la página anidada por separado o abra Any3D en una nueva pestaña
Proxy inversoUna mala configuración en Nginx/gateway puede provocar un tipo MIME incorrecto en los scripts de Worker
Filtro DNS parental en routerPoco común para Worker, pero si el sitio completo se degrada a un espejo HTTP, Worker dejará de funcionar

Autoprueba: Desconecte la VPN, cambie a un punto de acceso 4G/5G y observe si el aviso desaparece.

Referencia CSP corporativa (para IT)

Si Any3D se incrusta en un iframe, se recomienda permitir:

worker-src 'self' blob:;
script-src 'self' 'unsafe-eval' blob:;

Los usuarios individuales no necesitan modificar CSP manualmente.

Corrección paso a paso (general)

  1. Confirme el acceso por HTTPS y actualice la página (Ctrl+F5 / Cmd+Shift+R).
  2. Use una ventana de incógnito para descartar extensiones.
  3. Actualice el navegador y (en Android) el WebView del sistema.
  4. Abra Any3D directamente en una nueva pestaña, evitando el iframe de portales corporativos.

Autoprueba rápida

typeof Worker !== "undefined"

Retorna true solo si la API existe; Any3D también necesita OffscreenCanvas y createImageBitmap disponibles para completar la ruta de Worker.

Impacto cuando no hay Worker

FuncionalidadImpacto
Compresión de vértices (Draco, etc.)Generalmente sigue funcionando (hilo principal + WASM)
Compresión de texturas / KTX2Ruta de Worker no disponible; archivos grandes pueden bloquearse
Conversión de imagen a modeloPuede degradarse o tener un rendimiento significativamente menor

Conclusión

El aviso de Web Worker suele deberse a no HTTPS, WebView antiguo, CSP/VPN corporativos o bloqueo por extensiones. Actualice el navegador por plataforma, verifique cambiando de red y pida a IT que revise iframe/CSP para restaurar la capacidad de procesamiento en segundo plano.

Apóyanos