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 启用。标准档不申请额外功能,只使用核心能力。如果高画质申请失败,重新获取适配器尝试标准档;仍失败则保留页面并给出替代预览。

编写可运行的检测页面
将下面内容保存为 index.html。这份示例负责能力协商与显示所选配置,不包含实际粒子渲染;当无法创建 WebGPU 设备时,会在 Canvas 2D 中画出静态示意,并告知原因。查询参数 ?standard 和 ?static 用于模拟降级分支,方便测试。
<!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/:
python3 -m http.server 8000预期结果:服务器保持运行,浏览器显示所选档位。在支持 WebGPU 但不符合高档条件的设备上,页面文本类似:
模式:标准 WebGPU;纹理边长目标:4096;粒子数:100000;缓冲字节数:3200000验证分支并排查不兼容情况
- 访问
http://localhost:8000/?standard,在可用的 WebGPU 设备上应显示标准档,且不申请shader-f16。 - 访问
http://localhost:8000/?static,应显示“静态预览”提示及青绿色圆形,不再尝试取得适配器。 - 去掉查询参数重新加载:支持全部高档条件的设备显示高画质,否则降为标准档;若无法取得适配器或创建设备,则显示静态预览。
如果 navigator.gpu 不存在,先确认页面使用 HTTPS 或 localhost,再检查浏览器是否实现并允许 WebGPU。若适配器存在但资源创建报校验错误,应打印并核对 device.limits,尤其不要把较高的 adapter.limits 直接当成设备已获授权的上限。shader-f16 只有在设备中启用且 WGSL 着色器按该能力编写时才能使用。即使数值限制达标,大纹理的真实内存分配仍可能失败;正式演示应另设资源预算,并在 device.lost 后停止提交 GPU 命令、保留可读提示,必要时让用户重新初始化。