跳到主要内容

3D 模型问题

了解模型状态

生成 3D 模型时,它会经历多个阶段。您可以在控制面板中每道菜品旁边看到当前状态:

  • 等待中 — 模型生成请求已加入队列,正在等待处理。这通常只持续几秒钟。
  • 生成中 — 我们的 AI 正在根据您的照片创建 3D 模型。根据菜品的复杂程度,这通常需要 2 到 5 分钟。
  • 处理中 — 正在优化原始 3D 模型,使其在移动设备上快速加载。这包括压缩纹理、减少多边形数量以及应用高效编码。
  • 就绪 — 模型已完成并在您的菜单上线。顾客现在可以以 3D 方式与其互动。
  • 失败 — 生成过程中出现了问题。如果源照片不适合进行 3D 转换,就可能发生这种情况。请参阅下方的故障排查提示。

WebGL 和浏览器支持

可交互的 3D 模型需要 WebGL,这是一种用于渲染 3D 图形的浏览器技术。大多数现代浏览器都支持 WebGL:

  • Chrome(桌面端和移动端)— 完全支持
  • Safari(桌面端和 iOS)— 完全支持
  • Firefox(桌面端和移动端)— 完全支持
  • Samsung Internet — 完全支持
  • 旧版浏览器 — 可能部分支持或不支持

如果顾客的浏览器不支持 WebGL,菜单会自动降级为显示照片而不是 3D 模型。顾客仍能看到您的菜品 — 只是无法旋转和缩放。

设备降级行为

MenuGaze 会自动检测顾客设备的性能,并选择最佳的浏览体验:

  • 高端设备(4+ GB 内存、现代 GPU)— 使用 React Three Fiber 渲染完整的可交互 3D,旋转和缩放流畅
  • 中端设备(2-4 GB 内存)— 使用 Google Model Viewer 提供更轻量的 3D 体验,视觉质量相同
  • 低端设备(低于 2 GB 内存、不支持 WebGL)— 降级为显示封面图或原始照片

这种自动检测意味着您无需担心设备差异。每位顾客都能看到其设备所能提供的最佳体验。

模型生成失败时

如果模型生成失败,您可以点击控制面板上的 “重试” 按钮再次尝试。重试前,请考虑源照片是否合适:

  • 菜品应清晰可见且光线充足
  • 避免使用带有浓重阴影、滤镜或叠加文字的照片
  • 照片应从上方或以 45 度角展示食物
  • 避免使用菜品被画面边框部分截断的照片

如果同一张照片反复失败,请尝试上传同一道菜的另一张照片,并改用该照片生成模型。某些构图比其他构图更适合 3D 转换。

这对您有帮助吗?