Web 图形与 3D / 系统课时

获取适配器并创建设备

获取适配器并创建设备

在浏览器中使用 WebGPU 前,需要先获取 GPU 适配器,再创建逻辑设备并保存默认命令队列。本课使用 requestAdapter() 和 requestDevice() 完成最小初始化,让后续渲染与计算代码能够复用设备,同时正确处理环境不支持、设备请求失败和设备丢失。

学习目标

  • 检查浏览器的 WebGPU 支持情况与安全上下文要求。
  • 使用 requestAdapter()、requestDevice() 获取设备并保存 queue。
  • 区分初始化失败与运行期间设备丢失,掌握对应处理方法。

检查 WebGPU 运行条件

WebGPU 从 navigator.gpu 进入,要求浏览器支持相关 API,并处于安全上下文。实际开发建议使用 HTTPS 页面或 http://localhost,不要直接依赖普通 HTTP 远程地址。

在支持 WebGPU 的现代浏览器中打开 HTTPS 页面,按 F12 进入开发者工具的 Console。初始化前需要确认两项条件:

  1. window.isSecureContext 为 true,说明当前页面满足安全上下文要求。
  2. navigator.gpu 存在,说明浏览器向当前页面暴露了 WebGPU 入口。

即使入口存在,也不代表一定能够获得适配器。操作系统、显卡驱动、浏览器策略或设备能力限制,都可能使后续请求失败。

申请适配器、设备与队列

初始化采用异步流程:先等待 navigator.gpu.requestAdapter(),确认结果不是 null;再调用适配器的 requestDevice()。创建成功后,从设备的 queue 属性取得默认命令队列。

下面是可以直接粘贴到浏览器 Console 运行的完整 JavaScript 示例。使用 gpuState 统一保存对象,避免后续模块重复申请设备。

js
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 且设备创建成功时):

text
device ready: true
queue ready: true

device ready 验证设备对象已经保存,queue ready 验证保存的队列就是设备提供的默认 GPUQueue。这只证明初始化成功,不代表已经提交 GPU 绘制或计算任务。

后续创建 GPU 资源时使用 gpuState.device,执行 queue.submit() 提交命令缓冲区时使用 gpuState.queue。不要尝试从 GPUAdapter 读取 queue,因为默认队列属于 GPUDevice。

理解请求链路与设备生命周期

初始化中有两个需要等待的 Promise,但它们的失败形式不同:requestAdapter() 在找不到合适适配器时可以返回 null;requestDevice() 对不受支持的特性或限制等无效请求会拒绝 Promise。设备创建后仍可能异步丢失,因此不能把初始化成功视为永久有效。

WebGPU 适配器、设备和默认命令队列的申请流程及失败分支

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 就是后续图形渲染和计算任务的统一入口。开始创建资源前还应检查它们是否仍然有效;如果已被清空,应先完成设备恢复,而不是继续向旧队列提交命令。

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

目录与阅读设置

阅读设置

17

记录一个想法

获取适配器并创建设备

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

登录哪都通