メインコンテンツへスキップ

リファレンス

3D モデルの仕様

3D モデルの仕様

このページでは、3D Menu Pro で使用される 3D モデルの生成および最適化パイプラインについて、詳細な技術リファレンスを提供します。

出力形式

すべての 3D モデルは GLB (glTF Binary) ファイルとして提供されます。GLB はウェブ上の 3D コンテンツの業界標準であり、Three.js や <model-viewer> ウェブコンポーネントを含む、主要なすべてのブラウザとフレームワークでサポートされています。

サイズ上限

最適化後の最終モデルの最大サイズは 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> ウェブコンポーネントに自動的にフォールバックします。 WebGL と model-viewer のどちらもサポートされていない場合は、代わりに補正済みの 2D 写真が表示されます。