WebGPU: Sorun giderme ipuçları ve düzeltmeleri

François Beaufort
François Beaufort
GitHub

Bu dokümanda, WebGPU'nun neden Chrome tarayıcıda çalışamaması veya beklendiği gibi çalışmayabileceği açıklanmakta ve mümkün olduğunda sorunları çözmek için net adımlar yer almaktadır.

Aşağıdaki örnekte, gpu navigator'te kullanılamadığında karşılaşabileceğiniz bir JavaScript hatası gösterilmektedir:

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

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

Bunun nedeni aşağıdakilerden biri olabilir. Aşağıdaki sırayla bu öğelere göz atın:

  1. WebGPU, ChromeOS, macOS ve Windows'ta Chrome 113 veya sonraki bir sürümü, Android'de ise Chrome 121 veya sonraki bir sürümü gerektirir. chrome://version adresinden sürümünüzü kontrol edin ve gerekirse güncelleyin.

  2. WebGPU'ye yalnızca güvenli bağlamlardan erişilebilir. Kodunuzu güvenli olmayan bir protokol üzerinden (ör. http:, file:) sunuyorsanız güvenli https: protokolünü kullanın veya web uygulamanızın geliştirilmesi sırasında aşağıdaki yöntemlerden biriyle bu sorunu giderin:

    • Kodunuzu npx http-server veya python3 -m http.server komutlarından birini kullanarak http://localhost ya da http://127.0.0.1 üzerinde yerel olarak yayınlayın.

    • Kaynağı, chrome://flags/#unsafely-treat-insecure-origin-as-secure'ün "Güvenli olarak değerlendirilen güvenli olmayan kaynaklar" listesine ekleyin ve Chrome'u yeniden başlatın.

    • Node.js'yi yükleyin ve klasörünüzü sahte sertifika ile https üzerinden yayınlamak için npx servez --ssl komutunu çalıştırın. Chrome'da bir uyarı almaya devam edersiniz. Daha sonra "Gelişmiş"i, ardından "Devam et..."i tıklayarak bunu atlayabilirsiniz.

    • ngrok ile yerel web sunucunuzu internete açın.

GPU adaptörü null

Aşağıda, requestAdapter() çağrısından aldığınız bağdaştırıcının null olduğunda karşılaşabileceğiniz bir JavaScript hatası örneği verilmiştir:

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

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

Bunun nedeni aşağıdakilerden biri olabilir. Aşağıdaki sırayla bu öğelere göz atın:

  1. Kullanıcı chrome://settings/system'te "Kullanılabilir olduğunda grafik hızlandırmayı kullan" ayarını kapattığında WebGPU devre dışı bırakılır. Bu ayarın kapalı olup olmadığını kontrol edin ve tekrar açın

  2. WebGPU henüz bu platformda desteklenmiyor. chrome://flags/#enable-unsafe-webgpu işaretini etkinleştirip Chrome'u yeniden başlatabilirsiniz. Linux deneysel desteği için chrome://flags/#enable-vulkan işaretini de etkinleştirmeniz gerekir. Daha fazla bilgi edinmek için Başsız Chrome'da WebGPU desteği başlıklı makaleyi inceleyin.

  3. GPU donanımı, özellikle engellenenler listesine eklenmiştir. chrome://gpu bölümünde "WebGPU, engellenenler listesi veya komut satırı aracılığıyla devre dışı bırakıldı" ifadesini görürseniz chrome://flags/#enable-unsafe-webgpu işaretini etkinleştirip Chrome'u yeniden başlatarak WebGPU bağdaştırıcılar engellenenler listesini devre dışı bırakabilirsiniz.

  4. requestAdapter() içinde iletilen seçeneklerle eşleşen bir GPU adaptörü yok. requestAdapter() numaralı telefonu farklı seçeneklerle aramayı deneyin.

  5. WebGPU, GPU gerektirir (donanım veya yazılım emülasyonu). Chrome'un GPU algılayıp algılamadığını chrome://gpu adresini ziyaret ederek kontrol edebilirsiniz.

  6. GPU işlemi birkaç kez kilitlendi. Sayfayı yeniden yükleyebilir veya Chrome'u yeniden başlatabilirsiniz. Daha fazla bilgi edinmek için WebGPU cihaz kaybıyla ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.

WebGPU, WebGL'den daha yavaştır

  1. chrome://gpu simgesini açın ve "WebGPU: Donanım hızlandırmalı" ifadesini okuyabildiğinizden emin olun. "WebGPU: Yalnızca yazılım, donanım hızlandırma kullanılamıyor" ifadesini görüyorsanız GPU sürücülerinizi güncellemeniz gerekebilir.

  2. WebGL kavramlarını doğrudan WebGPU'ya çevirmek, WebGPU'nun benzersiz optimizasyonlarından tam anlamıyla yararlanmıyor olabilir. Bazı farkları öğrenmek için WebGPU'dan WebGPU'ya başlıklı makaleye bakın.

Windows'a özgü sınırlamalar

Windows cihazlarda WebGPU'yu kullanırken aşağıdaki sınırlamalara dikkat edin:

  • Chrome, aynı anda birden fazla GPU adaptörünün kullanılmasını desteklemez. chromium:329211593 numaralı soruna bakın.

  • Chrome, diğer Chrome iş yükleri için ayrılan GPU adaptörünü her zaman kullanır. Bu adaptör, dizüstü bilgisayarlarda güç kullanımı (ör. güç tasarrufu) nedeniyle genellikle entegre grafik kartı olur. Bu durumda, requestAdapter() çağrılırken powerPreference seçeneğinin herhangi bir etkisi yoktur.