WebGPU: טיפים ותיקונים לפתרון בעיות

François Beaufort
François Beaufort

במסמך הזה מוסבר למה יכול להיות ש-WebGPU לא יפעל או לא יפעל כצפוי בדפדפן Chrome, ומפורטים בו שלבים ברורים לפתרון הבעיות, במידת האפשר.

בדוגמה הבאה מוצגת שגיאת JavaScript שעשויה להופיע אם gpu לא זמין ב-navigator:

const adapter = await navigator.gpu.requestAdapter();
cancel Uncaught TypeError: Cannot read properties of undefined (reading 'requestAdapter')

אלה הסיבות האפשריות לדחיית הבקשה. כדאי לבדוק את האפשרויות הבאות בסדר הבא:

  1. כדי להשתמש ב-WebGPU, צריך להשתמש ב-Chrome מגרסה 113 ואילך ב-ChromeOS, ב-macOS, ב-Windows וב-Chrome מגרסה 121 ואילך ב-Android. מומלץ לבדוק את הגרסה בכתובת chrome://version ולעדכן אותה לפי הצורך.

  2. הגישה ל-WebGPU זמינה רק להקשרים מאובטחים. אם אתם מציגים את הקוד באמצעות פרוטוקול לא מאובטח (לדוגמה, http:, ‏ file:), עליכם להשתמש בפרוטוקול המאובטח https: או לטפל בבעיה הזו במהלך הפיתוח של אפליקציית האינטרנט באחת מהדרכים הבאות:

    • מציגים את הקוד באופן מקומי ב-http://localhost או ב-http://127.0.0.1 באמצעות אחת מהפקודות הבאות: npx http-server או python3 -m http.server.

    • צריך להוסיף את המקור לרשימה 'מקורות לא מאובטחים שמטופלים כבטוחים' של chrome://flags/#unsafely-treat-insecure-origin-as-secure ולהפעיל מחדש את Chrome.

    • מתקינים את Node.js ומריצים את npx servez --ssl כדי להציג את התיקייה דרך https עם אישור מזויף. עדיין תופיע אזהרה ב-Chrome, אבל תוכלו לדלג עליה בלחיצה על 'מתקדם' ואז על 'המשך אל…'.

    • חשיפת שרת האינטרנט המקומי לאינטרנט באמצעות ngrok.

מתאם ה-GPU ריק

הדוגמה הבאה היא של שגיאת JavaScript שעשויה להופיע כשהמתאם שמתקבל מהקריאה ל-requestAdapter() הוא null:

const adapter = await navigator.gpu.requestAdapter();
const device = await adapter.requestDevice();
cancel Uncaught TypeError: Cannot read properties of undefined (reading requestDevice)

יכולות להיות לכך כמה סיבות. כדאי לבדוק את אלה שמופיעים בסדר הזה:

  1. WebGPU מושבת אם המשתמש השבית את האפשרות 'שימוש בהאצת גרפיקה כשהאפשרות זמינה' ב-chrome://settings/system. בודקים אם ההגדרה הזו מושבתת ומפעילים אותה מחדש.

  2. עדיין אין תמיכה ב-WebGPU בפלטפורמה הזו. אפשר להפעיל את הדגל chrome://flags/#enable-unsafe-webgpu ולהפעיל מחדש את Chrome. כדי לקבל תמיכה ניסיונית ב-Linux, צריך גם להפעיל את הדגל chrome://flags/#enable-vulkan. מידע נוסף זמין במאמר תמיכה ב-WebGPU ב-Chrome ללא ממשק משתמש.

  3. חומרת ה-GPU נוספה באופן ספציפי לרשימת החסימה. אם מופיעה ההודעה 'WebGPU הושבת באמצעות רשימת החסימות או שורת הפקודה' בקובץ chrome://gpu, אפשר להשבית את רשימת החסימות של מתאמי WebGPU על ידי הפעלת הדגל chrome://flags/#enable-unsafe-webgpu והפעלה מחדש של Chrome.

  4. אין מתאם GPU תואם לאפשרויות שהועברו ב-requestAdapter(). אפשר לנסות להתקשר אל requestAdapter() עם אפשרויות אחרות.

  5. ל-WebGPU נדרש GPU (אמולציית חומרה או תוכנה). כדי לבדוק אם Chrome מזהה GPU, אפשר להיכנס לכתובת chrome://gpu.

  6. תהליך ה-GPU קרס כמה פעמים. אפשר לטעון מחדש את הדף או להפעיל מחדש את Chrome. למידע נוסף, אפשר לעיין במאמר שיטות מומלצות לאובדן מכשיר WebGPU.

WebGPU איטי יותר מ-WebGL

  1. פותחים את chrome://gpu ומוודאים שאפשר לקרוא את הכיתוב 'WebGPU: Hardware accelerated'. אם מופיעה ההודעה 'WebGPU: תוכנה בלבד, האצת חומרה לא זמינה', יכול להיות שתצטרכו לעדכן את מנהלי ההתקן של ה-GPU.

  2. יכול להיות שהתרגום הישיר של מושגי WebGL ל-WebGPU לא ינצל את כל היתרונות של האופטימיזציות הייחודיות של WebGPU. במאמר מ-WebGL ל-WebGPU מוסבר על חלק מההבדלים ביניהם.

מגבלות ספציפיות ל-Windows

חשוב לשים לב למגבלות הבאות כשמשתמשים ב-WebGPU במכשירי Windows:

  • ב-Chrome אין תמיכה בשימוש בכמה מתאמי GPU בו-זמנית. בעיה chromium:329211593

  • Chrome תמיד משתמש באותו מתאם GPU שהוקצה לעומסי עבודה אחרים של Chrome. במחשבים ניידים, בדרך כלל זה כרטיס הגרפיקה המובנה, בגלל היבטי צריכת החשמל (למשל: חיסכון בחשמל). המשמעות היא שלאפשרות powerPreference אין השפעה על קריאה ל-requestAdapter().