Web 图形与 3D / 系统课时

校验设备特性并制定降级路径

校验设备特性并制定降级路径

同一份 WebGPU 演示可能在桌面设备上正常运行,却因纹理尺寸、缓冲区限制或可选功能缺失而无法启动。本课把能力探测变成可执行的三级策略:满足条件时启用高画质,否则降低资源规模;不支持 WebGPU 时提供明确说明和静态预览。

学习目标

  • 识别 navigator.gpu、GPUAdapter.features 与 GPUAdapter.limits 的职责。
  • 按纹理边长、缓冲区大小和 shader-f16 功能选择运行档位。
  • 实现设备申请失败及设备丢失时的降级提示,并验证各条路径。

先确定每个档位的硬性需求

以一个粒子演示为例,假设每个粒子占 32 字节,使用一个存储缓冲区保存状态。把画质目标写成可检查的数字,而不是按设备品牌猜测性能。

档位 纹理最大边长目标 粒子数 着色器要求
高画质 WebGPU 16384 像素 1000000 允许使用 shader-f16
标准 WebGPU 4096 像素 100000 使用普通 f32
静态预览 不创建 GPU 纹理 0 使用 Canvas 2D

高画质单缓冲需要 1000000 × 32 = 32000000 字节,标准档为 3200000 字节。检查粒子缓冲区时,既要看 maxBufferSize,也要看单个存储绑定的 maxStorageBufferBindingSize;两项限制不是同一个含义。maxTextureDimension2D 约束二维纹理的单边尺寸,不是可用显存大小。

按支持能力选择设备申请路径

页面首先应检查是否处于 HTTPS 或 localhost 等安全上下文,再判断 navigator.gpu 是否存在、requestAdapter() 是否返回适配器。适配器的 features 和 limits 表示可申请能力;真正用于资源合法性校验的是所创建设备的 device.limits 和 device.features。

高画质档只有在适配器支持 shader-f16、16384 纹理边长和 32000000 字节单缓冲时才申请。因为 16384 超过常见的 8192 默认二维纹理限制,需要在 requestDevice() 中指定 requiredLimits.maxTextureDimension2D;可选功能也必须通过 requiredFeatures 启用。标准档不申请额外功能,只使用核心能力。如果高画质申请失败,重新获取适配器尝试标准档;仍失败则保留页面并给出替代预览。

WebGPU 设备能力检测、设备申请与三级降级流程

编写可运行的检测页面

将下面内容保存为 index.html。这份示例负责能力协商与显示所选配置,不包含实际粒子渲染;当无法创建 WebGPU 设备时,会在 Canvas 2D 中画出静态示意,并告知原因。查询参数 ?standard 和 ?static 用于模拟降级分支,方便测试。

html
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>WebGPU 能力自检</title></head>
<body>
  <h1>WebGPU 能力自检</h1>
  <p id="status">正在检查设备……</p>
  <canvas id="preview" width="320" height="180" hidden></canvas>
  <script type="module">
    const status = document.querySelector("#status");
    const preview = document.querySelector("#preview");
    const params = new URLSearchParams(location.search);
    const forceStatic = params.has("static");
    const forceStandard = params.has("standard");

    function showStatic(reason) {
      preview.hidden = false;
      const ctx = preview.getContext("2d");
      if (ctx) {
        ctx.fillStyle = "#eaf1f5";
        ctx.fillRect(0, 0, 320, 180);
        ctx.fillStyle = "#0f9d91";
        ctx.beginPath();
        ctx.arc(160, 90, 30, 0, Math.PI * 2);
        ctx.fill();
      }
      status.textContent = `静态预览:${reason}。请使用支持 WebGPU 的浏览器,并通过 HTTPS 或 localhost 访问。`;
    }

    async function init() {
      // 安全上下文是 WebGPU 的前置条件。
      if (!window.isSecureContext) {
        showStatic("页面不处于安全上下文");
        return;
      }
      // 用查询参数验证兜底页面,不依赖真实的硬件故障。
      if (forceStatic || !navigator.gpu) {
        showStatic("WebGPU 不可用或已模拟禁用");
        return;
      }
      const adapter = await navigator.gpu.requestAdapter();
      if (!adapter) {
        showStatic("没有可用的 GPUAdapter");
        return;
      }

      const highBytes = 1_000_000 * 32;
      let high = !forceStandard &&
        adapter.features.has("shader-f16") &&
        adapter.limits.maxTextureDimension2D >= 16384 &&
        adapter.limits.maxBufferSize >= highBytes &&
        adapter.limits.maxStorageBufferBindingSize >= highBytes;
      let device;

      try {
        // 为计划使用 f16 的高画质路径申请额外能力。
        device = await adapter.requestDevice(high ? {
          requiredFeatures: ["shader-f16"],
          requiredLimits: { maxTextureDimension2D: 16384 }
        } : {});
      } catch {
        if (!high) {
          showStatic("标准设备申请失败");
          return;
        }
        // 失败后重新获取适配器,再尝试不带额外要求的设备。
        const basicAdapter = await navigator.gpu.requestAdapter();
        if (!basicAdapter) {
          showStatic("无法取得备用适配器");
          return;
        }
        try {
          device = await basicAdapter.requestDevice();
          high = false;
        } catch {
          showStatic("高画质与标准设备申请均失败");
          return;
        }
      }

      const texture = high ? 16384 : 4096;
      const particles = high ? 1_000_000 : 100_000;
      const bytes = particles * 32;
      // 创建资源前必须使用 device.limits 做最终检查。
      if ((high && !device.features.has("shader-f16")) ||
          device.limits.maxTextureDimension2D < texture ||
          device.limits.maxBufferSize < bytes ||
          device.limits.maxStorageBufferBindingSize < bytes) {
        showStatic("设备实际限制不足");
        return;
      }
      status.textContent = `模式:${high ? "高画质" : "标准"} WebGPU;纹理边长目标:${texture};粒子数:${particles};缓冲字节数:${bytes}`;
      device.lost.then(info => showStatic(`GPU 设备已丢失(${info.reason})`));
    }

    init().catch(() => showStatic("GPU 初始化异常"));
  </script>
</body>
</html>

预期结果:页面在设备可用时显示高画质或标准档位;不可用时出现静态预览及原因。保存文件后,在所在目录运行本地服务器,再打开 http://localhost:8000/:

bash
python3 -m http.server 8000

预期结果:服务器保持运行,浏览器显示所选档位。在支持 WebGPU 但不符合高档条件的设备上,页面文本类似:

text
模式:标准 WebGPU;纹理边长目标:4096;粒子数:100000;缓冲字节数:3200000

验证分支并排查不兼容情况

  1. 访问 http://localhost:8000/?standard,在可用的 WebGPU 设备上应显示标准档,且不申请 shader-f16。
  2. 访问 http://localhost:8000/?static,应显示“静态预览”提示及青绿色圆形,不再尝试取得适配器。
  3. 去掉查询参数重新加载:支持全部高档条件的设备显示高画质,否则降为标准档;若无法取得适配器或创建设备,则显示静态预览。

如果 navigator.gpu 不存在,先确认页面使用 HTTPS 或 localhost,再检查浏览器是否实现并允许 WebGPU。若适配器存在但资源创建报校验错误,应打印并核对 device.limits,尤其不要把较高的 adapter.limits 直接当成设备已获授权的上限。shader-f16 只有在设备中启用且 WGSL 着色器按该能力编写时才能使用。即使数值限制达标,大纹理的真实内存分配仍可能失败;正式演示应另设资源预算,并在 device.lost 后停止提交 GPU 命令、保留可读提示,必要时让用户重新初始化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

校验设备特性并制定降级路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通