3D モデルの仕様
このページでは、3D Menu Pro で使用される 3D モデルの生成および最適化パイプラインについて、詳細な技術リファレンスを提供します。
出力形式
すべての 3D モデルは GLB (glTF Binary) ファイルとして提供されます。GLB はウェブ上の
3D コンテンツの業界標準であり、Three.js や
<model-viewer> ウェブコンポーネントを含む、主要なすべてのブラウザとフレームワークでサポートされています。
サイズ上限
最適化後の最終モデルの最大サイズは 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> ウェブコンポーネントに自動的にフォールバックします。
WebGL と model-viewer のどちらもサポートされていない場合は、代わりに補正済みの 2D 写真が表示されます。