3D 模型规格
本页详细介绍 3D Menu Pro 所使用的 3D 模型生成和优化流水线的技术参考。
输出格式
所有 3D 模型均以 GLB(glTF Binary)文件形式交付。GLB 是网页上
3D 内容的行业标准,受到所有主流浏览器和框架的支持,包括 Three.js 和
<model-viewer> Web 组件。
大小限制
最终优化模型的大小上限为 2 MB。在首轮优化后仍超过此限制的模型会被自动简化。当模型超过 2 MB 且多边形数量超过 10,000 时,会触发自动简化。如果无法获取多边形数量数据,系统会默认执行简化,作为一项安全措施。
优化流水线
每个生成的 3D 模型都会经过多阶段优化流水线,以确保在移动设备上快速加载:
- 去重 — 删除重复的访问器、材质、网格和纹理,以减少冗余。
- 裁剪 — 删除未使用的节点、材质以及其他对可见模型没有贡献的资源。
- 焊接 — 合并位置和属性相同的顶点,减少顶点数量。
- 简化 — 在保持视觉保真度的同时减少多边形数量。使用 meshoptimizer 库进行兼顾质量的网格抽取。
- 量化 — 降低顶点属性(位置、法线、UV)的精度,以更少的内存占用换取极小的视觉影响。
- 纹理压缩 — 将纹理转换为 WebP 格式,在保持视觉质量的同时减小文件大小。
- Draco 压缩 — 应用 Draco 网格压缩,最终进一步减小文件大小。Draco 由浏览器在加载时解码。
模型状态
| 状态 | 描述 | 持续时间 |
|---|---|---|
PENDING |
菜品已在处理队列中排队,等待可用的工作进程。 | 视队列长度而定 |
GENERATING |
AI 提供商正在根据输入照片生成 3D 模型。 | 30 秒到 2 分钟 |
PROCESSING |
生成的模型正在通过上述流水线进行优化。 | 10 到 30 秒 |
READY |
模型已优化并在公开菜单上线。 | 最终状态 |
FAILED |
处理过程中出错。可在仪表板中重试。 | 最终状态(直到重试) |
获取超时
系统在模型交付过程中会强制执行超时,以避免加载缓慢的体验:
- 海报图片获取:30 秒超时
- 模型下载:120 秒超时
如果模型下载超时,查看器会回退到海报图片(增强后的照片),确保顾客始终能看到内容。
WebGL 兼容性
3D 模型在浏览器中使用 WebGL 渲染。如果 WebGL 不可用,或上下文丢失(这可能发生在内存受限的移动设备上),查看器会自动回退到
<model-viewer> Web 组件,该组件具有广泛的兼容性。如果 WebGL 和 model-viewer 均不受支持,则会改为显示增强后的
2D 照片。