気になる結果が出たら

GLB最適化のトラブルシューティング

元のファイルを残してください。多くの問題は「控えめな最適化」に戻し、1回につき1つの設定を変えることで切り分けられます。

「必要なリソースをすべて含む .glb ファイルを1つ選んでください」

.gltfの拡張子を.glbに変えても変換にはなりません。バッファと画像を埋め込んだバイナリglTFを書き出してください。本サービスはdata URIを含む外部参照を拒否し、処理前にGLB構造を検証します。

Dracoまたは未対応の必須拡張機能

元の制作ツールから、Draco圧縮なしで書き出し直してください。必須拡張機能が未対応なら、それを使わず外観を保てる出力方法を選びます。ファイルの拡張機能リストから名前を削除しても、データに互換性が生まれるわけではありません。

結果のほうが大きい

もともと小さい入力は、必ずしも縮まりません。使用先がMeshoptに対応していれば「ファイルを小さく」を試してください。テクスチャが容量の大半を占めるなら、KTX2やWebPと、より小さな最大サイズを試します。バイト数だけでなく画質と互換性も比べ、利点がなければ元のファイルを使ってください。

テクスチャが欠ける、または出力を読み込めない

まず元のテクスチャ形式を保持して試してください。それで動けば、使用先のKTX2・WebP対応を確認します。Meshopt出力ではデコーダーの設定を確認してください。ブラウザーのプレビューエラーは端末の制約でも起こり得ます。使用先で元のモデルを試し、次も参照してください: 互換性ガイド.

モデルの見た目が変わる

三角形の目標保持率を100%に戻し、元のテクスチャを保持して、保持設定を有効にします。形状、透明部分、マテリアル、アニメーションを個別に確認してください。この設定でも最適化による変更はあります。アプリケーションが未対応のメタデータや厳密な構造に依存する場合は、元データを保持するか、ローカルエンジンのより細かなオプションを検討してください。

処理が止まる、キューを利用できない

現在の上限は、アップロード1件50 MB、出力1件100 MB、1回の処理120秒です。申告された展開後のバッファは256 MiBまでです。圧縮ファイルのサイズだけではメモリ使用量は分かりません。テクスチャの枚数や寸法を減らす、テクスチャ変換を無効にする、またはネイティブエンジンをローカルで使う方法を試してください。

キューの満杯やワーカーの停止は一時的な状態です。後で再試行してください。レート制限の応答が返った場合は、追加のアップロードを送る前にお待ちください。

ダウンロードの期限が切れた

結果はキュー待ちと処理時間を含め、アップロードから60分後に期限切れになります。元のタスクページから早めにダウンロードしてください。タスクが失効したりトークンを紛失したりした場合は、元のファイルを再アップロードします。本サービスは一時処理用であり、ファイル保管用ではありません。

gltfpackでGLBのポリゴンを削減する →

最適化後にGLBが大きくなる理由 →

最適化ツールを開く ↗