OffscreenCanvas non disponibile? Guida alla risoluzione per piattaforma e ambiente
Sintomi riscontrati
Any3D mostra il messaggio «Il browser corrente non supporta OffscreenCanvas». Questo è uno dei tre componenti essenziali per il percorso in Worker; senza di esso, processi come la compressione delle texture che richiedono l'encoding WebGL2 all'interno di un Worker non possono essere eseguiti correttamente.
OffscreenCanvas consente di creare un canvas in un Web Worker e ottenere un contesto WebGL, completando operazioni GPU in background senza bloccare la pagina.
Cause comuni
| Causa | Scenario tipico |
|---|---|
| Browser/WebView obsoleto | Chrome < 69, Safari < 16.4, vecchio Android WebView |
| Accelerazione hardware disattivata | Risparmio energetico o strategie che disabilitano la GPU su Windows/macOS |
| Politiche aziendali | GPO che disabilita la GPU, MDM che limita le capacità grafiche |
| WebView integrato | WeChat, app aziendali, vecchi gusci Electron |
| Livello di rete | Raro; spesso si tratta di fallimento nel caricamento degli script piuttosto che dell'API stessa |
Risoluzione per piattaforma
Windows
- Chrome / Edge: Impostazioni → Sistema → Attiva "Usa accelerazione hardware" → Esci completamente e riavvia il browser.
- Driver della scheda video: Su portatili con doppia GPU, assicurati che il browser utilizzi la scheda dedicata (Pannello di controllo NVIDIA / AMD Software).
- Criteri di gruppo: Le politiche tipo "Disabilita accelerazione hardware" causano la creazione fallita del contesto WebGL in OffscreenCanvas.
- Desktop remoto (RDP): Alcune sessioni RDP limitano le capacità della GPU; esegui un confronto effettuando l'accesso locale.
macOS
- Safari 16.4+ o Chrome più recente.
- Impostazioni di sistema → Batteria: la modalità risparmio energetico può ridurre l'assegnazione delle risorse alla GPU; riprova con l'alimentazione di rete collegata.
- Tempo di utilizzo dello schermo generalmente non disabilita direttamente OffscreenCanvas, ma se un MDM limita le API grafiche, contatta l'ufficio IT.
Linux
- Verifica che i driver Mesa/propri siano funzionanti; testa con Chrome più recente sia su Wayland che su X11.
- I browser remoti su server headless richiedono una GPU virtuale (scenario personale raro).
iOS / iPadOS
- Safari si aggiorna con il sistema (il supporto completo a OffscreenCanvas inizia da iOS 16.4+).
- Il WebView integrato nelle app potrebbe essere in ritardo rispetto a Safari di sistema — apri il link direttamente in Safari.
- Gli iPad scolastici in modalità di gestione potrebbero essere bloccati su un vecchio sistema; è necessaria un'aggiornamento dall'amministratore.
Android
- Aggiorna Chrome e Android System WebView.
- I browser nazionali con nucleo di compatibilità non lo supportano → passa al nucleo rapido o usa Chrome.
- Driver GPU obsoleti su dispositivi entry-level: prova a disattivare la "Modalità risparmio energetico" e riprova.
Rete, VPN e ambiente aziendale
OffscreenCanvas è un'API locale e generalmente non è influenzata direttamente dalla VPN. Tuttavia, se la VPN causa il downgrade del browser in "modalità sicura" o caricamento di script iniettati da estensioni aziendali, potrebbe fallire indirettamente:
- Disconnetti la VPN per confronto;
- Verifica se il browser aziendale forza il "Rendering software";
- Se integrato in un iframe, assicurati che il livello superiore non blocchi il WebGL all'interno del Worker.
Controlli parentali e dispositivi gestiti
- Family Link / Tempo di utilizzo dello schermo: raramente disabilitano direttamente OffscreenCanvas; è più comune che vietino l'installazione degli aggiornamenti del browser, portando un'API obsoleta — consenti aggiornamenti automatici del sistema.
- Modalità esame/biblioteca: potrebbe essere utilizzato un browser personalizzato; si consiglia di utilizzare un dispositivo personale.
Risoluzione passo-passo (generica)
- Aggiorna il browser a una versione superiore a quelle minime indicate nella tabella.
- Attiva l'accelerazione hardware e riavvia il browser.
- Apri il browser di sistema, non usare il WebView integrato nelle app.
- Se hai anche errori relativi a WebGL2, prima segui la Guida alla risoluzione di WebGL2.
Auto-test rapido
typeof OffscreenCanvas !== "undefined"
Restituisce false se l'ambiente corrente non supporta questa API.
Riepilogo
La mancanza di OffscreenCanvas è comune nei browser/WebView obsoleti, con accelerazione hardware disattivata, in sessioni remote Windows o con politiche aziendali sulla GPU. Attivare l'accelerazione GPU per piattaforma, aggiornare il WebView e utilizzare il browser di sistema permette solitamente di ripristinare la capacità di encoding GPU all'interno dei Worker.