跳到主要内容

参考

3D 模型规格

3D 模型规格

本页详细介绍 3D Menu Pro 所使用的 3D 模型生成和优化流水线的技术参考。

输出格式

所有 3D 模型均以 GLB(glTF Binary)文件形式交付。GLB 是网页上 3D 内容的行业标准,受到所有主流浏览器和框架的支持,包括 Three.js 和 <model-viewer> Web 组件。

大小限制

最终优化模型的大小上限为 2 MB。在首轮优化后仍超过此限制的模型会被自动简化。当模型超过 2 MB 且多边形数量超过 10,000 时,会触发自动简化。如果无法获取多边形数量数据,系统会默认执行简化,作为一项安全措施。

优化流水线

每个生成的 3D 模型都会经过多阶段优化流水线,以确保在移动设备上快速加载:

  1. 去重 — 删除重复的访问器、材质、网格和纹理,以减少冗余。
  2. 裁剪 — 删除未使用的节点、材质以及其他对可见模型没有贡献的资源。
  3. 焊接 — 合并位置和属性相同的顶点,减少顶点数量。
  4. 简化 — 在保持视觉保真度的同时减少多边形数量。使用 meshoptimizer 库进行兼顾质量的网格抽取。
  5. 量化 — 降低顶点属性(位置、法线、UV)的精度,以更少的内存占用换取极小的视觉影响。
  6. 纹理压缩 — 将纹理转换为 WebP 格式,在保持视觉质量的同时减小文件大小。
  7. 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 照片。