WebGPU: suggerimenti per la risoluzione dei problemi e correzioni

François Beaufort
François Beaufort
GitHub

Questo documento spiega perché WebGPU potrebbe non essere utilizzabile o non funzionare come previsto nel browser Chrome, con passaggi chiari per risolvere i problemi, ove possibile.

L'esempio seguente mostra un errore JavaScript che potresti ricevere quando gpu non è disponibile in navigator:

const adapter = await navigator.gpu.requestAdapter();

cancel Uncaught TypeError: Cannot read properties of undefined (reading 'requestAdapter')

Ciò potrebbe essere dovuto a uno dei seguenti motivi. Dai un'occhiata ai risultati in questo ordine specifico:

  1. WebGPU richiede Chrome 113 o versioni successive su ChromeOS, macOS, Windows e Chrome 121 o versioni successive su Android. Controlla la versione all'indirizzo chrome://version e, se necessario, esegui l'aggiornamento.

  2. WebGPU è accessibile solo per contesti sicuri. Se pubblichi il codice su un protocollo non sicuro (ad esempio, http:, file:), utilizza il protocollo https: sicuro oppure risolvi il problema durante lo sviluppo della tua app web in uno dei seguenti modi:

    • Pubblica il codice localmente su http://localhost o http://127.0.0.1 con uno di questi comandi: npx http-server o python3 -m http.server.

    • Aggiungi l'origine a "Origini non sicure trattate come sicure" elenco di chrome://flags/#unsafely-treat-insecure-origin-as-secure e riavvia Chrome.

    • Installa Node.js ed esegui npx servez --ssl per gestire la cartella su https con un certificato falso. In Chrome continuerai a ricevere un avviso che puoi ignorare facendo clic su "Avanzate" quindi su "Procedi a...".

    • Esponi il tuo server web locale su internet con ngrok.

L'adattatore GPU è nullo

Di seguito è riportato un esempio di un errore JavaScript che potresti ricevere quando l'adattatore ottenuto chiamando requestAdapter() è nullo:

const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();

cancel Uncaught TypeError: Cannot read properties of undefined (reading requestDevice)

Ciò si verifica per uno dei seguenti motivi. Dai un'occhiata ai risultati in questo ordine specifico:

  1. WebGPU viene disattivata se l'utente ha disattivato l'opzione "Usa accelerazione grafica quando disponibile" nel seguente paese: chrome://settings/system. Verifica se questa impostazione è disattivata e riattivala

  2. WebGPU non è ancora supportata su questa piattaforma. Puoi attivare il flag chrome://flags/#enable-unsafe-webgpu e riavviare Chrome. Per il supporto sperimentale Linux, dovrai attivare anche il flag chrome://flags/#enable-vulkan. Per scoprire di più, consulta il supporto delle GPU WebGPU in Chrome Headless.

  3. L'hardware GPU è stato specificamente inserito in una lista bloccata. Se viene visualizzato il messaggio "WebGPU è stata disabilitata tramite lista bloccata o la riga di comando" in chrome://gpu, puoi disattivare la lista bloccata degli adattatori WebGPU attivando il flag chrome://flags/#enable-unsafe-webgpu e riavviando Chrome.

  4. Non esiste un adattatore GPU corrispondente per le opzioni ignorate in requestAdapter(). Prova a chiamare requestAdapter() con opzioni diverse.

  5. WebGPU richiede una GPU (emulata da hardware o software). Puoi controllare se Chrome rileva una GPU visitando la pagina chrome://gpu.

WebGPU è più lento di WebGL

  1. Apri chrome://gpu e assicurati di leggere "WebGPU: accelerazione hardware". Se leggi il messaggio "WebGPU: solo software, accelerazione hardware non disponibile", potrebbe essere necessario aggiornare i driver della GPU.

  2. La traduzione diretta dei concetti WebGL in WebGPU potrebbe non sfruttare appieno le ottimizzazioni uniche di WebGPU. Visita la pagina Da WebGL a WebGPU per scoprire alcune delle differenze.

Limitazioni specifiche per Windows

Tieni presente le seguenti limitazioni quando utilizzi WebGPU su dispositivi Windows:

  • Chrome non supporta l'utilizzo di più adattatori GPU contemporaneamente. Consulta il problema chromium:329211593.

  • Chrome utilizza sempre lo stesso adattatore GPU che è stato assegnato per altri carichi di lavoro Chrome, che per i laptop è in genere la scheda grafica integrata a causa dell'aspetto del consumo energetico (ad es. il risparmio energetico). Significa che l'opzione powerPreference non ha alcun impatto sulla chiamata a requestAdapter().