Version: 1.11
语言 : 中文
Vulkan(Preview)
平台支持

WebGPU(实验性)

WebGPU 是 W3C 制定的下一代 Web 图形 API 标准,旨在替代 WebGL,提供更接近现代图形硬件底层的能力。团结引擎支持在小游戏平台和 Web 平台上启用 WebGPU 图形 API,解锁 Compute Shader、VFX、Indirect Draw 等原生级渲染特性。

渲染增强

相较于 WebGL 2.0,WebGPU 提供以下增强能力:

  • Compute Shader:支持在 GPU 上进行并行数据计算,适用于复杂的模拟或特效处理。
  • VFX:可用于实现更复杂、运行更高效的视觉特效。
  • Indirect Draw:可实现更高效的渲染调用调度,减少 CPU 开销。
  • Storage Texture:支持在 Shader 中直接读写纹理数据。
  • 纹理格式扩展:支持 BGRA8、纹理压缩格式(BC / ETC2 / ASTC)等更多原生纹理格式。

支持平台

小游戏平台

  • 微信小游戏

  • 抖音

注意:微信和抖音平台正在推进 WebGPU 支持,具体可用版本以平台官方公告为准。

Web 平台

  • Chrome:(≥113)
  • Edge:(≥113)
  • 其他基于 Chromium 内核的浏览器

注意:Firefox 对 WebGPU 的支持尚不完善(mapAsync 在 Firefox ≤151 存在已知缺陷),建议优先使用 Chrome 系浏览器进行测试。

启用方式

小游戏平台

  1. 在 Project Settings -> Player 中,选择 MiniGame 平台页签。
  2. 在 Graphics APIs 列表中添加 WebGPU。
  3. 为保证跨设备兼容性,建议同时保留 OpenGLES3 作为回退 API,并将 WebGPU 排在列表最前面。引擎会在运行时根据设备支持情况自动选择最佳 API。

Web 平台

  1. 在 Project Settings -> Player 中,选择 Web 平台页签。
  2. 在 Graphics APIs 列表中添加 WebGPU。
  3. 建议将 WebGPU 排在 WebGL 2 之前,引擎会优先尝试 WebGPU,在不支持的浏览器上自动回退到 WebGL 2。

注意事项

浏览器兼容性

  • WebGPU 在不同浏览器和不同版本上的支持程度不同。引擎会在运行时检测 navigator.gpu 是否可用,若不可用则自动回退到 WebGL 2.0。
  • iOS Safari 对 WebGPU 的支持取决于系统版本,建议使用 iOS 17.0 及以上版本。

安全上下文要求

  • WebGPU 属于安全上下文(Secure Context)API,浏览器仅在 HTTPS 或 localhost 环境下暴露 navigator.gpu。通过 HTTP 访问时 navigator.gpu 为 undefined,引擎将自动回退到 WebGL 2.0。请确保小游戏 CDN 资源和运行环境使用 HTTPS。

功能限制

  • Async Compute:当前版本暂不支持。
  • GPU Readback:WebGPU 的回调模型不支持同步 GPU 数据回读。AsyncGPUReadback 的同步等待模式(wait=true)会直接返回错误,请使用异步轮询方式(每帧调用 Update() 检查状态)。依赖 GPU 回读的 API(如 Texture2D.GetPixels、ScreenCapture.CaptureScreenshot)在 WebGPU 下不可用。
  • 严格的 Uniformity 分析:WebGPU 要求只能在非均匀块(non-uniform block)中调用屏障函数,否则 Shader 编译会失败。以下 HLSL 屏障函数受此限制:
    • GroupMemoryBarrier / GroupMemoryBarrierWithGroupSync
    • DeviceMemoryBarrier / DeviceMemoryBarrierWithGroupSync
    • AllMemoryBarrier / AllMemoryBarrierWithGroupSync
  • HLSL 扩展特性:WebGPU 不支持以下 HLSL 扩展功能:
    • Wave Intrinsics(WaveBasic、WaveVote、WaveBallot、WaveMath、WaveMultiPrefix)
    • QuadShuffle
    • Int64
    • Native16Bit
  • Compute Shader 限制:
    • WebGPU 不支持 RWBuffer,Shader 编译器会自动将其替换为 RWStructuredBuffer。
    • 读写存储纹理(Read-Write Storage Texture)仅支持有限的纹理格式。HLSL 不显式声明存储纹理的访问类型,而是根据用法判断: RWTexture2D tex; // 存储纹理 tex[uv] = 1.0f; // 仅写入 tex[uv] += 1.0f; // 读写
    • WebGPU 不支持 RGBA8 或 RHalf 作为读写存储纹理格式。如果使用这些格式创建 RenderTexture,需将 enableRandomWrite 设为 false(默认值)。
  • Render Texture 通道限制:
    • 如果 RenderTexture 为 RGBA 格式(4 通道),Fragment Shader 必须输出 float4 或 half4。输出 float 或 half 会导致 WebGPU 报错,因为部分通道未被初始化。
    • 如果 RenderTexture 为 R8 格式(1 通道),Fragment Shader 可以输出 float 或 half,也可以输出 float4 / half4(多余通道会被忽略)。
  • Terrain 纹理限制:WebGPU 对地形纹理的支持存在限制,具体可参考 W3 WebGPU 规范。

资源打包要求

  • 启用 WebGPU 后需重新构建 AssetBundle,以确保包含 WebGPU Shader 变体。
  • 同时启用 WebGPU 与 WebGL 时,Shader 变体会同时包含两个平台的数据,包体体积会有所增加。

与其他图形 API 共存设置

WebGPU 在不同设备和浏览器上的支持程度不同,建议在 Graphics API 列表中同时添加多个 API,引擎会在运行时按优先级顺序自动选择最佳可用 API。推荐的优先级顺序为:Metal > WebGPU > OpenGLES3 / WebGL 2。

  • 与 Metal 共存:Metal 仅支持 iOS 设备,直接调用原生图形 API,在 iOS 上性能优于 WebGPU。建议将 Metal 排在 WebGPU 之前,iOS 设备优先使用 Metal,其他设备使用 WebGPU 或回退到 WebGL。
  • 与 WebGL 共存:WebGPU 在部分设备或浏览器上可能不可用,建议保留 OpenGLES3 / WebGL 2 作为回退 API。
  • 包体影响:同时启用多个图形 API 会导致:
    • Wasm 包体体积少许增加
    • Shader 资源变大(同时存在多个平台的 Shader 变体)

实验性功能

  • 该功能当前处于实验阶段,欢迎开发者参与体验。
Vulkan(Preview)
平台支持