createImageBitmap non disponibile? Risoluzione per piattaforma e ambiente

Sintomo riscontrato

Any3D visualizza "Il browser corrente non supporta createImageBitmap". Questa è una delle tre funzionalità fondamentali del percorso Worker, utilizzata per decodificare i pixel delle immagini in background in modo efficiente. In sua assenza, i flussi come la compressione delle texture e la conversione immagini in modelli non possono completare il percorso Worker completo, causando rallentamenti con file di grandi dimensioni.

Cause comuni

Causa	Scenario tipico
Browser/WebView obsoleto	Vecchio Android WebView, pagine incorporate nelle app
Contesto non sicuro	Siti HTTP (non localhost), file://
Risorse cross-origin non configurate correttamente	CDN/CORS aziendali che causano errori nella decodifica delle immagini (si manifesta come malfunzionamento funzionale)
Limiti di memoria/schede	Dispositivi mobili a bassa memoria, politiche aziendali "singola scheda"
Interferenze delle estensioni	Plugin per la privacy che modificano il comportamento dell'API Image

Risoluzione per piattaforma

Windows / macOS (desktop)

1. Utilizzare le versioni stabili più recenti di Chrome / Edge / Firefox / Safari.
2. Aprire Any3D esclusivamente tramite HTTPS.
3. Tempo di utilizzo dello schermo su macOS e Sicurezza famiglia su Windows se limitano i download o l'accesso ai media, potrebbero influenzare la decodifica delle immagini grandi — testare con un account amministratore.
4. Desktop remoto: texture a risoluzione estremamente alta potrebbero fallire nella decodifica in ambienti GPU deboli, prima verificare con immagini piccole.

Linux

1. Aggiornare Chrome/Firefox; in caso di decodifica GPU anomala su Wayland, provare un confronto con una sessione X11 (raro).

iOS / iPadOS

n

1. Safari 14+ offre un buon supporto fin dall'inizio; mantenere aggiornato il sistema iOS.
2. Il kernel del browser integrato in WeChat spesso è obsoleto → aprire in Safari.
3. Proxy dedicato iCloud / Restrizione contenuti per adulti generalmente non bloccano createImageBitmap, ma potrebbero bloccare repository di immagini cross-origin — assicurarsi che le texture del modello siano stesse origine o accessibili.

Android

1. Aggiornare Chrome e Android System WebView (Impostazioni → App → Mostra app di sistema).
2. Modalità di compatibilità dei browser cinesi → passare a Chrome.
3. Salute digitale / Family Link quando limitano le attività in background non influenzano direttamente l'API, ma potrebbero bloccare il caricamento di file grandi.

Rete, VPN e rete aziendale

Scenario	Spiegazione
VPN aziendale	Se le texture del modello passano per CDN interno, errori CORS o certificato causano fallimento della decodifica — la Console mostrerà errori di rete
Proxy trasparente	Quando sostituisce o danneggia le risposte delle immagini, createImageBitmap potrebbe rigettare
Rete interna solo HTTP	Contesto non sicuro, l'API potrebbe non essere disponibile o con comportamento limitato
Zero Trust / Ispezione SSL	I certificati auto-firmati devono essere importati e considerati affidabili, altrimenti il caricamento delle risorse fallisce

Consiglio: scollegare la VPN, passare a un hotspot, caricare un modello geometrico puro senza texture esterne per testare — se la geometria funziona ma le texture no, indagare prima sulla rete/CORS.

Politiche aziendali e controlli parentali

• Intune App Protection potrebbe limitare "Salva come/Download", influenzando indirettamente il flusso di selezione immagine dell'utente, ma l'API stessa dovrebbe essere presente — utilizzare la Console per testare e distinguere.
• Gestione iPad scolastici: quando blocca l'"App File" non influenza l'API, ma influisce sul metodo di caricamento; utilizzare canali di caricamento supportati.
• DNS parental sul router: se blocca il dominio Any3D, l'intero sito non funziona, non solo createImageBitmap.

Correzione passo-passo (generica)

1. HTTPS + browser aggiornato + riavvio.
2. Finestra di navigazione in incognito per escludere le estensioni.
3. Aprire nel browser di sistema, non nella WebView dell'app.
4. Controllare contemporaneamente se anche Web Worker e OffscreenCanvas segnalano avvisi.

Auto-test rapido

typeof createImageBitmap !== "undefined"

Avanzato (richiede HTTPS e un URL di immagine accessibile):

fetch("https://example.com/favicon.ico")
  .then((r) => r.blob())
  .then((b) => createImageBitmap(b))
  .then(() => console.log("ok"))
  .catch(console.error);

Riepilogo

I problemi con createImageBitmap sono spesso causati da WebView obsolete, HTTPS mancante, VPN/rete interna che impedisce il caricamento delle risorse. Aggiornando la WebView per piattaforma, cambiando rete per verifica ed escludendo le estensioni, il percorso di elaborazione immagini in Worker può di solito essere ripristinato.