2027 网页 3D 查看器实测:GLB 与高斯 PLY
用真实 GLB 与高斯 PLY 对比 model-viewer 和 Spark,展示宽窄视口、45° 相机验证和文件缺失回退。

同一座石屋可以交付为 GLB 网格,也可以交付为高斯 PLY。两份文件都在 4.4 MB 左右,网页需要按实际格式选查看器。我们用 Google 的 model-viewer 打开网格,用 Spark 打开泼溅,两边都在 Chromium 里转动相机,再故意换成不存在的地址检查回退。下面比较格式、相机控制和加载失败处理,帮助你决定产品预览该怎么接。
先说结论
- model-viewer 4.4.0 打开了 4,312,248 字节的 GLB。Spark 2.0.0 解析并渲染了 4,456,863 字节的 PLY。两份分别包含 18,459 个三角面和 65,536 个高斯。
- 在 1,380 和 430 CSS 像素宽的两种视口,两边都能加载,并能用按钮让相机改变 45°。窄视口是桌面浏览器的布局实测。
- 把两个模型地址换成缺失文件后,页面用原图替代 3D,并停用了对应的旋转按钮。
- GLB 组件发出 load 事件。Spark 初始化完成后,再由应用的渲染循环显示场景。埋点时应分别记录这两种信号。
两种查看器各自需要什么文件
GLB 是同图高斯泼溅与网格对比里的 Tripo H3.1 网格,PLY 来自 TripoSplat 官方公开 Demo。查看器实验复用这两份原始文件。它们对应同一张输入图,但存储的结构与外观信息不同,加载方法也不同。
| 项目 | model-viewer 加载 GLB | Spark 加载高斯 PLY |
|---|---|---|
| 实测版本 | model-viewer 4.4.0 | Spark 2.0.0 与 Three.js |
| 文件字节 | 4,312,248 | 4,456,863 |
| 原始结构 | 18,459 个三角面 | 65,536 个高斯 |
| 显示方式 | 组件加载并渲染 GLB | 泼溅对象进入带 Spark 渲染器的 Three.js 场景 |
| 本次相机 | 组件自带轨道相机 | 应用管理透视相机 |
| 加载失败 | 组件 error 事件 | HTTP 检查和初始化异常处理 |
| 回退 | 显示原图并停用旋转 | 显示原图并停用旋转 |
如果交付要求是 GLB,且组件的旋转与展示设置够用,可以先试 model-viewer。如果交付的是高斯 PLY,页面已经用 Three.js 或计划自建场景,可以从 Spark 开始。后者需要配置相机、画布、布局和异常处理。即使查看器能打开某类容器,也要确认它支持文件用到的具体编码和扩展。用准备交付的文件在生产加载路径里验一次。 model-viewer 文档 · Spark 概览
验证加载和相机转动

组件和 Spark 分别渲染真实文件。两侧按钮都在测试中触发,构图和外观会受各自查看器影响。
GLB 一侧启用 camera-controls,等组件发出 load 事件。测试先读当前的 theta,将目标方位加 45°,调用 jumpCameraToGoal(),等待更新后再读实际相机角度。两个视口中实测都转了 π/4。最初直接在设置目标后读取,读到的还是旧值。最终测试等状态更新再断言。这一步对自动记录交互很重要。
PLY 一侧先取二进制并核对响应,再用字节初始化 SplatMesh。相机由应用控制。按钮给当前轨道角加 π/4,重新计算相机位置并对准主体中心。这个样本在加入场景前做了方向调整和居中。有些文件的向上轴和页面不同,可以把导入变换随文件或路线配置保存,再截一张预期起始角度作对照。 Spark SplatMesh 文档
| 验证项 | 1,380 像素视口 | 430 像素视口 |
|---|---|---|
| GLB load 事件 | 收到 | 收到 |
| PLY 初始化 | 完成 | 完成 |
| 更新后 GLB 的 theta 变化 | 0.7854 弧度 | 0.7854 弧度 |
| PLY 相机的转动指令 | 0.7854 弧度 | 0.7854 弧度 |
| 测试页布局 | 双列 | 上下排列 |

桌面 Chromium 的响应式布局截图。两个画布与相机按钮在窄视口下仍可见。
窄屏布局通过后,实际手机仍需要验证。本文两份文件从本地加载,Chrome 使用软件渲染路径。我们记录的是状态事件、相机动作和渲染效果。用真实设备时,分别量首个可用画面、网络传输、内存和拖动响应。组件的 load 与 PLY 的初始化完成对应不同阶段,不能直接拿这两个时间做速度排名。
模型地址失效时保留预览

缺失路径触发两条加载失败分支,渲染区域换成原图,旋转按钮停用。
失败实验只改了文件地址。GLB 组件发出 error,PLY 的请求返回真实 HTTP 404。两侧调用相同回退逻辑,用原图替换渲染区,停用旋转。状态文案明确表示正在展示图片。这在原图和 3D 首帧很像时尤其重要,避免用户以为画面卡住了。
上线后根据失败类型处理。路径拼错时修文件引用,或者让用户先用预览图。网络中断时,可以提供一次重载同一文件的操作。查看器加载失败时,先检查交付地址与已验证文件。若生成接口给的是临时地址,确认文件已转存到自己的交付地址并能取回,再将任务标为可用。 异步图生 3D 后台实测
本文验证的是缺失文件。也可以用一份损坏的副本或当前查看器不支持的扩展,补测异常。Spark 分支处理失败的 HTTP 响应和解析错误,GLB 分支监听组件 error。切换资产时,确认旧模型已移除。回退图应有自己的有效路径,避免和 3D 一起失效。对外发布前,也可以验证刷新页面和快速切换模型时状态是否仍与当前文件一致。
根据文件和产品交互选路线
如果资产库以带贴图的网格为主,先挑能打开真实 GLB、有确定的相机初始位置且能报告失败状态的组件。试一份常规资产,再试一份逼近实际贴图或几何预算的文件。需要拆开量体积,可以参考移动端 GLB 预算实测。如果以泼溅展示为主,先用能读高斯属性的查看器测试 PLY,核对方向、相机边界和斜角效果。
两种格式并存时,把格式记在资产 ID 旁,按它选择加载器。验收记录可以同时保存文件字节、查看器版本、相机默认值、回退图和结果。每次发布前验证一次正常加载、一次转动和一次文件缺失。查看器能显示文件只是交付检查中的一步,模型的几何、贴图和主体部件另行验收。 GLB 自动验收
要拿一份网格试,可以从 Tripo H3.1 图生 3D 生成 GLB。此次 PLY 来自 TripoSplat 官方 Demo,先前的 SandBase TripoSplat 路线 请求返回上游 404。本文查看器测试针对两份已保存的文件。换成其他泼溅输出时,先确认 Spark 能读取编码,再复测相机和回退。
把验收动作保存成可重复的测试
测试脚本可以在加载状态出现后再触发相机动作,等待组件更新后记录实际角度。如果模型只显示了静态图,断言对应按钮已停用。两个查看器各自保存截图和状态,后续升级依赖或更换文件时,可以对照渲染区域、相机变化及回退文案。测试还可以记录当前文件哈希,避免把上一次加载成功的资产当成本次结果。
常见问题
高斯 PLY 能直接给 model-viewer 吗?
本文用 model-viewer 打开 GLB。高斯 PLY 交给能解析其属性的渲染器,例如实测的 Spark。
430 CSS 像素是否等于手机测试?
这是对同一浏览器的窄布局检查。真实设备用于测网络、性能和触摸交互。
回退图放什么?
可以放产品照片或预先渲染的静态图,并标明当前无法显示 3D。静态图应能单独使用,交互按钮要等 3D 准备好再启用。
觉得有用?分享给更多人