外观
WebGL渲染错误弹窗
约 1586 字
问题的现象
访问页面时,弹出“WebGL 渲染时发生错误,渲染已经停止”窗口。

问题的原因
一旦出现这个窗口,就代表 WebGL 渲染中发生了错误且渲染已经停止。WebGL 类似桌面程序,一旦崩溃就需要刷新当前页面或重启整个浏览器才能重新访问页面。
出现该错误后,需要从以下几个方面排查问题。
- 请确认访问系统的电脑使用独立显卡,且 GPU 显存不低于 2GB。
- 选择一款合适的浏览器(推荐 Chrome)并升级到最新版本。
- 该错误是否可以一直重现?如果一直重现,则是代码或数据有问题;如果只是偶尔出现,则不是代码问题。
- 如果是代码问题,要查找从没有错误到出现错误之间改动了哪些代码,可以通过注释部分代码来排查问题,也可能是传入的参数或坐标数值有误造成的。
- 如果只是偶尔出现,可以排查是否三维模型或数据量太大。该错误也常见于数据量太大、超出 GPU 内存造成崩溃的情况。
- 如果只是偶尔出现,也可能是鼠标操作拖动使视角处于平视或仰角时,Cesium 内部计算出了问题。
解决方法及步骤
如果是模型本身太大造成 WebGL 崩溃
如果模型本身太大造成 WebGL 崩溃,目前对 3DTiles 模型可以从下面 3 个方法入手:
- 数据处理层面:包括数据处理工具的选择,以及工具本身一些优化参数的设置,可以尝试不同的参数优化压缩和数据结构,进行性能调优。
- 网络传输层面:通过 nginx 加 gzip 压缩,提高传输速度。
- 客户端 JS 代码层面:参考API 文档添加一些参数,在效果和效率之间取平衡值。
以下参数可用于 3DTiles 总数据量大、清晰度过高情况下的性能优化。这不是一个通用的解决方案,但可以以此为参考:
maximumScreenSpaceError: 16, // 【重要】数值加大,能让最终成像变模糊
maxMemory: 1024, // 最大缓存内存大小(MB)
maximumMemoryUsage: 512, //【cesium 1.107+弃用】内存建议显存大小的50%左右,内存分配变小有利于倾斜摄影数据回收,提升性能体验
skipLevelOfDetail: true, //是Cesium在1.5x 引入的一个优化参数,这个参数在金字塔数据加载中,可以跳过一些级别,这样整体的效率会高一些,数据占用也会小一些。但是带来的异常是:1) 加载过程中闪烁,看起来像是透过去了,数据载入完成后正常。2,有些异常的面片,这个还是因为两级LOD之间数据差异较大,导致的。当这个参数设置false,两级之间的变化更平滑,不会跳跃穿透,但是清晰的数据需要更长,而且还有个致命问题,一旦某一个tile数据无法请求到或者失败,导致一直不清晰。所以我们建议:对于网络条件好,并且数据总量较小的情况下,可以设置false,提升数据显示质量。
loadSiblings: true, // 如果为true则不会在已加载完模型后,自动从中心开始超清化模型
cullRequestsWhileMoving: true,
cullRequestsWhileMovingMultiplier: 10, //【重要】 值越小能够更快的剔除
preferLeaves: true, //【重要】这个参数默认是false,同等条件下,叶子节点会优先加载。但是Cesium的tile加载优先级有很多考虑条件,这个只是其中之一,如果skipLevelOfDetail=false,这个参数几乎无意义。所以要配合skipLevelOfDetail=true来使用,此时设置preferLeaves=true。这样我们就能最快的看见符合当前视觉精度的块,对于提升大数据以及网络环境不好的前提下有一点点改善意义。
progressiveResolutionHeightFraction: 0.5, //【重要】 数值偏于0能够让初始加载变得模糊
dynamicScreenSpaceError: true, // true时会在真正的全屏加载完之后才清晰化模型
preloadWhenHidden: true, //tileset.show是false时,也去预加载数据- 客户端加载模型后,如果在远视视角下看到模型是一块一块的 Tile 小正方形逐步加载的,说明数据缺少顶层瓦片数据,建议使用 cesiumlab 等工具进行“重建顶层”
如果希望崩溃后页面自动刷新
如果在正式部署的系统中,希望 WebGL 崩溃后页面自动刷新,可以在 map 构造完成后添加下面代码:
// webgl渲染失败后,刷新页面
map.on(mars3d.EventType.renderError, (event) => {
window.location.reload();
});附:WebGL 介绍
WebGL 是一种 JavaScript API,用于在不使用插件的情况下,在任何兼容的网页浏览器中呈现交互式 2D 和 3D 图形。WebGL 完全集成到浏览器的所有网页标准中,可将影像处理和效果的 GPU 加速当作网页 Canvas 的一部分。WebGL 元素可以加入其他 HTML 元素之中,并与网页或网页背景的其他部分混合。WebGL 程序由 JavaScript 编写的句柄和 OpenGL Shading Language(GLSL)编写的着色器代码组成。
检查 WebGL 支持度
首先,通过浏览器访问WebGL Report 网站,检查浏览器是否支持 WebGL 以及支持的特性清单。目前,大多数平台和浏览器都支持 WebGL,在这些环境下运行 Cesium 并没有太大的问题,但效果和性能能否满足不同的需求,就需要考虑很多细节和额外因素。
- 无论是 PC 还是移动端,Chrome 都是 WebGL 开发和应用的最佳平台,如果没有特殊的硬性要求,建议使用 Chrome。
- IE11 对 WebGL 的支持尚可,但不支持深度纹理,需要升级到 Edge;
- 在移动平台,WebGL 调度比较消耗资源,受目前 GPU 硬件能力的限制,容易造成内存崩溃、机器发烫等问题。
