Web 图形与 3D / 系统课时
获取适配器并创建设备
获取适配器并创建设备
在浏览器中使用 WebGPU 前,需要先获取 GPU 适配器,再创建逻辑设备并保存默认命令队列。本课使用 requestAdapter() 和 requestDevice() 完成最小初始化,让后续渲染与计算代码能够复用设备,同时正确处理环境不支持、设备请求失败和设备丢失。
学习目标
- 检查浏览器的 WebGPU 支持情况与安全上下文要求。
- 使用
requestAdapter()、requestDevice()获取设备并保存queue。 - 区分初始化失败与运行期间设备丢失,掌握对应处理方法。
检查 WebGPU 运行条件
WebGPU 从 navigator.gpu 进入,要求浏览器支持相关 API,并处于安全上下文。实际开发建议使用 HTTPS 页面或 http://localhost,不要直接依赖普通 HTTP 远程地址。
在支持 WebGPU 的现代浏览器中打开 HTTPS 页面,按 F12 进入开发者工具的 Console。初始化前需要确认两项条件:
window.isSecureContext为true,说明当前页面满足安全上下文要求。navigator.gpu存在,说明浏览器向当前页面暴露了 WebGPU 入口。
即使入口存在,也不代表一定能够获得适配器。操作系统、显卡驱动、浏览器策略或设备能力限制,都可能使后续请求失败。
申请适配器、设备与队列
初始化采用异步流程:先等待 navigator.gpu.requestAdapter(),确认结果不是 null;再调用适配器的 requestDevice()。创建成功后,从设备的 queue 属性取得默认命令队列。
下面是可以直接粘贴到浏览器 Console 运行的完整 JavaScript 示例。使用 gpuState 统一保存对象,避免后续模块重复申请设备。
const gpuState = {
adapter: null,
device: null,
queue: null
};
async function initializeWebGPU() {
if (!window.isSecureContext) {
throw new Error("需要 HTTPS 或 localhost 安全上下文");
}
if (!navigator.gpu) {
throw new Error("当前浏览器未提供 WebGPU API");
}
const adapter = await navigator.gpu.requestAdapter();
if (!adapter) {
throw new Error("未找到可用的 GPU 适配器");
}
// 默认请求不要求额外特性,先确认基本设备可用
const device = await adapter.requestDevice();
gpuState.adapter = adapter;
gpuState.device = device;
gpuState.queue = device.queue;
// 设备可能在成功创建后因系统或驱动原因丢失
device.lost.then((info) => {
console.warn("GPU 设备已丢失:", info.reason, info.message);
if (gpuState.device === device) {
gpuState.device = null;
gpuState.queue = null;
}
});
console.log("device ready:", gpuState.device === device);
console.log("queue ready:", gpuState.queue === device.queue);
}
initializeWebGPU().catch((error) => {
console.error("WebGPU 初始化失败:", error.message);
});预期输出(浏览器支持 WebGPU 且设备创建成功时):
device ready: true
queue ready: truedevice ready 验证设备对象已经保存,queue ready 验证保存的队列就是设备提供的默认 GPUQueue。这只证明初始化成功,不代表已经提交 GPU 绘制或计算任务。
后续创建 GPU 资源时使用 gpuState.device,执行 queue.submit() 提交命令缓冲区时使用 gpuState.queue。不要尝试从 GPUAdapter 读取 queue,因为默认队列属于 GPUDevice。
理解请求链路与设备生命周期
初始化中有两个需要等待的 Promise,但它们的失败形式不同:requestAdapter() 在找不到合适适配器时可以返回 null;requestDevice() 对不受支持的特性或限制等无效请求会拒绝 Promise。设备创建后仍可能异步丢失,因此不能把初始化成功视为永久有效。

requestAdapter() 支持可选参数 powerPreference,例如 "high-performance" 或 "low-power",但它们只是适配器选择偏好,不保证一定使用独立显卡或集成显卡。首次接入通常直接调用无参数版本即可。
requestDevice() 也支持 requiredFeatures 和 requiredLimits。只有确实需要额外功能时才指定,并事先通过 adapter.features.has() 或 adapter.limits 检查能力;请求不受支持的能力可能导致设备申请失败。
定位失败并处理设备丢失
运行失败时,按错误出现的阶段逐项检查,而不是直接反复调用 requestDevice()。
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 安全上下文检查失败 | 页面使用不受信任的 HTTP 来源 | 改用 HTTPS 或 localhost |
navigator.gpu 不存在 |
浏览器不支持、未启用或当前环境限制 WebGPU | 检查浏览器版本、平台支持与安全上下文 |
requestAdapter() 返回 null |
无可用适配器或受到系统、浏览器策略限制 | 检查显卡驱动、GPU 加速状态与浏览器支持情况 |
requestDevice() 拒绝 |
请求的特性、限制不受支持或请求无效 | 检查异常信息,去掉不必要的 requiredFeatures、requiredLimits |
device.lost 完成 |
设备被销毁、系统资源管理或驱动状态变化 | 停止使用旧资源,重新初始化并重建 GPU 资源 |
示例中的 catch 负责处理初始化阶段抛出的错误,device.lost.then() 则处理设备创建成功之后的异步失效。两者不能互相替代。对于有效请求,设备也可能在返回时已经处于丢失状态,因此仍应注册丢失监听。
当设备丢失时,旧设备创建的缓冲区、纹理和管线不能直接移交给新设备。实际应用应停止相关渲染或计算任务,重新获取可用设备,再创建依赖它的 GPU 资源。若丢失原因是应用主动调用 device.destroy(),通常无需自动重试;其他原因可以采用有限次数和延迟重试,避免无限初始化循环。
完成验证后,gpuState.device 与 gpuState.queue 就是后续图形渲染和计算任务的统一入口。开始创建资源前还应检查它们是否仍然有效;如果已被清空,应先完成设备恢复,而不是继续向旧队列提交命令。