Any3DAny3D
·Any3D Team

Web Worker non disponibile? Diagnosi per piattaforma e ambiente

troubleshootingbrowser-compatibilityweb-worker

Sintomi che riscontri

In fondo a Any3D appare un avviso giallo: "Il browser attuale non supporta l'Web Worker". L'anteprima potrebbe comunque funzionare, ma l'elaborazione di file di grandi dimensioni può bloccare la pagina, e i percorsi Worker per la compressione delle texture e la conversione di immagini in modelli non possono essere attivati.

L'Web Worker permette ai calcoli intensivi di essere eseguiti in un thread in background. La compressione delle texture e parte dei processi di conversione di Any3D si basano sulla combinazione di Worker + OffscreenCanvas + createImageBitmap.

Cause comuni

CausaScenari tipici
Contesto non sicuroApertura con file://, pagina su HTTP in rete interna (non localhost)
Browser obsoleto / WebViewBrowser di sistema vecchie versioni, pagine integrate in app
Restrizioni CSPiframe di portali aziendali, client zero-trust che inietta worker-src
Blocco da estensionePlugin per la privacy che impedisce Worker o URL blob:
Anomalia nella cache di reteProxy/VPN che restituisce script Worker incompleti
Gestione del dispositivoProfili di configurazione che disabilitano gli script in background

Diagnosi per piattaforma

Windows

  1. Accedi obbligatoriamente tramite HTTPS (https://any3d.cc), non utilizzare file HTML locali.
  2. Criteri di group policy (GPO) di Edge: in Computer Configuration → Administrative Templates → Microsoft Edge verifica se vengono limitati i Worker o i cookie di terze parti (indirettamente influiscono sul caricamento di alcuni Worker).
  3. Sicurezza famiglia di Windows: i limiti web imposti per i sottoutenti potrebbero causare la creazione fallita del Worker.

macOS

  1. Safari / Chrome richiedono entrambi macOS 12+ e una versione recente del browser.
  2. Tempo di utilizzo dello schermo → Contenuti e privacy → se sono attivate "Restrizioni per i siti per adulti" o filtri personalizzati, potrebbero bloccare accidentalmente i nomi di dominio degli script Worker.
  3. Se il profilo MDM aziendale disabilita capacità di script diverse dal "cross-site tracking", contatta l'IT.

Linux

  1. Verifica che l'URL di accesso sia HTTPS; i proxy Squid aziendali devono consentire le relative richieste blob: e worker-src.

iOS / Android

  1. Non utilizzare il browser integrato in WeChat/DingTalk per l'elaborazione di file di grandi dimensioni; aprili con il browser di sistema.
  2. La modalità di risparmio energetico di iOS di solito non disabilita i Worker, ma vecchie versioni di WebKit potrebbero non supportare le API necessarie — mantieni il sistema aggiornato.
  3. Una versione obsoleta di Android WebView (WebView di sistema non aggiornato) può rendere il Worker non disponibile: aggiorna "Android System WebView" dal Play Store.

Rete, VPN e intranet aziendale

ScenariDescrizione
VPN aziendaleAlcune VPN forzano la decrittazione HTTPS e iniettano CSP; è necessario che l'IT autorizzi i Worker
Portallo SSO intranet in iframeLa CSP della pagina esterna potrebbe proibire worker-src blob:; è necessaria una configurazione separata nella pagina nidificata o aprire Any3D in una nuova scheda
Reverse proxyUna configurazione errata di Nginx/gateway potrebbe causare un tipo MIME errato per gli script Worker
Filtraggio DNS su router parentaliRaro per i Worker, ma se l'intero sito viene declassato a uno specchio HTTP, i Worker smettono di funzionare

Test autonomo: disconnettiti dalla VPN, passa a un hotspot 4G/5G e verifica se l'avviso scompare.

Riferimenti per CSP aziendali (per l'IT)

Se Any3D è incorporato in un iframe, si consente:

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

Gli utenti privati non devono modificare manualmente la CSP.

Procedura di correzione passo-passo (generica)

  1. Verifica l'accesso tramite HTTPS e ricarica la pagina (Ctrl+F5 / Cmd+Shift+R).
  2. Utilizza una finestra di navigazione in incognito per escludere le estensioni.
  3. Aggiorna il browser e (su Android) il WebView di sistema.
  4. Apri Any3D direttamente in una nuova scheda, evitando l'incorporamento in iframe di portali aziendali.

Test rapido

typeof Worker !== "undefined"

Un valore di ritorno true indica solo la presenza dell'API; Any3D richiede anche OffscreenCanvas e createImageBitmap per percorrere l'intero percorso Worker.

Impatto dell'assenza di Worker

FunzionalitàImpatto
Compressione dei vertici (Draco, ecc.)Generalmente ancora disponibile (thread principale + WASM)
Compressione texture / KTX2Percorso Worker non disponibile, possibile blocco con file grandi
Conversione da immagine a modelloPotrebbe essere degradata o con prestazioni significativamente ridotte

Gli avvisi sull'Web Worker derivano spesso da mancanza di HTTPS, WebView obsolete, CSP/VPN aziendali, estensioni che bloccano. Aggiornando il browser per piattaforma, cambiando rete per verifica e facendo controllare iframe/CSP dall'IT, si può normalmente ripristinare la capacità di elaborazione in background.

Supportaci