Web 图形与 3D / 系统课时
验证移动端着色器兼容边界
验证移动端着色器兼容边界
同一份 GLSL ES 3.00 特效在桌面正常,不代表在手机上能编译、能写入浮点渲染目标或保持流畅。本篇用浏览器能力探针和真机帧时间测试划出可用边界,再为 HDR、Bloom 与多 Pass 效果指定可验证的降级路径。
学习目标
- 检查 WebGL2、浮点颜色附件、GPU 计时扩展与精度上限。
- 用真实手机验证 Shader 编译、渲染结果和持续帧时间。
- 按能力缺失、性能不足、上下文丢失选择不同降级策略。
先区分功能支持与实际可用
canvas.getContext("webgl2") 返回非空,只说明能创建 WebGL2 上下文;并不保证浮点颜色纹理可以用作渲染目标。比如 HDR 后处理常用的 RGBA16F,需要启用 EXT_color_buffer_float,再用 checkFramebufferStatus 检查实际附件组合。EXT_disjoint_timer_query_webgl2 仅影响 GPU 计时能力,缺失不应直接禁用特效。
WebGL2 使用 GLSL ES 3.00,片元着色器可使用 highp float;大坐标、时间累加或高频噪声计算应显式声明精度。最大纹理尺寸和同时输出目标数是资源上限,不是 GPU 运行速度分数。正式适配应按“能力探测—真实渲染—性能分档”的顺序执行。

在手机浏览器运行能力探针
在目标手机打开实际 WebGL 页面,通过远程调试的 Console 运行以下完整 JavaScript。探针使用一个临时画布和 4×4 测试附件,不依赖 Three.js,也不会替换原页面的渲染器。
(() => {
const canvas = document.createElement("canvas");
const gl = canvas.getContext("webgl2");
if (!gl) {
console.log("WebGL2: 不可用");
console.log("策略: Canvas 2D 或静态图");
return;
}
// 扩展可用后,仍要实测指定浮点附件的完整性
const floatExt = gl.getExtension("EXT_color_buffer_float");
const timerExt = gl.getExtension("EXT_disjoint_timer_query_webgl2");
const highp = gl.getShaderPrecisionFormat(gl.FRAGMENT_SHADER, gl.HIGH_FLOAT);
let rgba16fOK = false;
if (floatExt) {
const texture = gl.createTexture();
const framebuffer = gl.createFramebuffer();
gl.bindTexture(gl.TEXTURE_2D, texture);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA16F, 4, 4, 0,
gl.RGBA, gl.HALF_FLOAT, null);
gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0,
gl.TEXTURE_2D, texture, 0);
rgba16fOK =
gl.checkFramebufferStatus(gl.FRAMEBUFFER) === gl.FRAMEBUFFER_COMPLETE;
// 释放探针资源,避免占用移动端显存
gl.bindFramebuffer(gl.FRAMEBUFFER, null);
gl.bindTexture(gl.TEXTURE_2D, null);
gl.deleteFramebuffer(framebuffer);
gl.deleteTexture(texture);
}
console.log("WebGL2: 可用");
console.log("RGBA16F 渲染目标:", rgba16fOK ? "可用" : "不可用");
console.log("GPU 计时扩展:", timerExt ? "可用" : "不可用");
console.log("最大纹理尺寸:", gl.getParameter(gl.MAX_TEXTURE_SIZE));
console.log("同时输出目标数上限:", gl.getParameter(gl.MAX_DRAW_BUFFERS));
console.log("片元 highp 精度位数:", highp?.precision ?? "未知");
})();预期输出示例(仅表示某一类设备的可能结果,实际扩展、数值和分支因设备而异):
WebGL2: 可用
RGBA16F 渲染目标: 可用
GPU 计时扩展: 不可用
最大纹理尺寸: 4096
同时输出目标数上限: 4
片元 highp 精度位数: 23若无法创建 WebGL2,上述代码只打印“WebGL2: 不可用”和静态降级策略。浮点附件探针通过后,还须在实际工程中编译、链接并绘制目标 Shader,检查 COMPILE_STATUS、LINK_STATUS 与画面是否正确;探针并不能证明每一份着色器都能工作。
在真实 GPU 负载下测帧时间
测试至少覆盖一台 Android 手机和一台 iPhone,以及各自实际使用的浏览器。不要拿桌面开发者工具的手机外观模拟模式代替真机。保持相同场景、动画、Pass 数和视口,先正常渲染 60 秒,再记录后半段至少 300 帧的帧间隔,分别比较中位数与第 95 百分位(P95)。60 Hz 屏幕以约 16.7 ms/帧为目标;若主动锁定 30 FPS,则预算约为 33.3 ms/帧。
在启用 EXT_disjoint_timer_query_webgl2 的设备上,可以异步读取 GPU 耗时,但必须等待查询结果可用且确认未发生 GPU_DISJOINT_EXT;没有扩展时使用浏览器性能分析工具判断瓶颈。requestAnimationFrame 的间隔代表呈现节奏,不能直接当作 GPU 执行时间。
像素成本也要实算:390×844 CSS 像素、DPR 为 3 时,绘图缓冲约 1170×2532,即 296 万像素;将有效 DPR 限至 2,变成 780×1688,约 132 万像素,减少约 56%。单张全尺寸 RGBA16F 纹理按 8 字节/像素计算,前者约 23.7 MB,后者约 10.5 MB,均未计深度、其他 Pass 和额外分配。
设置降级档位并验收
| 检测结果 | 实际处理 | 验收重点 |
|---|---|---|
| WebGL2 不可用 | 使用 Canvas 2D 或静态封面 | 页面能显示主内容 |
| Shader 编译或链接失败 | 切换经真机验证的简化 GLSL ES 3.00 材质 | 不黑屏,错误日志可定位 |
RGBA16F 附件不完整 |
后处理改用 RGBA8,HDR Bloom 改低动态范围近似或关闭 |
无帧缓冲错误、无异常高亮 |
| 帧时间 P95 超出目标预算 | 有效 DPR 先由 2 降到 1.5;模糊 9 次采样减到 5 次,必要时去掉一个 Pass | 连续运行后仍达帧率目标 |
| WebGL 上下文丢失 | 暂停绘制并展示备用画面;恢复事件后重建程序、纹理与帧缓冲 | 切回页面或内存压力后可恢复 |
Three.js 项目可以用 renderer.setPixelRatio(Math.min(window.devicePixelRatio, 1.5)) 限制渲染分辨率;原生 WebGL 则同步调整画布缓冲尺寸、gl.viewport 和分辨率 uniform。DPR 上限是起始策略,不是所有机型都必须固定为 1.5。
最终只有同时满足“实际 Shader 正常绘制、附件完整、持续帧时间达标、上下文恢复正常”的设备,才进入对应的高级特效档位。