·Any3D Team
WebAssembly が利用できない?プラットフォームと環境別にトラブルシューティング
troubleshootingbrowser-compatibilitywebassembly
見られる症状
モデルをアップロード後、Any3D が「現在のブラウザは WebAssembly をサポートしていません」と表示され、フォーマット変換、Draco 解凍、KTX2 テクスチャ圧縮などの操作が続行できません。
WebAssembly(WASM)はブラウザで高性能コードを実行する基盤です。Any3D の Draco、MeshOpt、IFC/STEP パース、KTX2 エンコーディングなどのモジュールはこれに依存しています。WASM がないと、メインの処理フローが直接ブロックされます。
一般的な原因
| 原因 | 典型的なシナリオ |
|---|---|
| ブラウザバージョンが古い | 社内ネットワークで長期間更新されていない Chrome、IE 互換モード |
| セキュリティポリシーが WASM を無効化 | 会社の GPO/MDM、保護者制限、国内ブラウザの「互換コア」 |
| 拡張機能やスクリプトによるブロック | 広告ブロッカー、プライバシープラグインが .wasm リソースを誤ってブロック |
| ネットワークミドルウェアによる干渉 | 会社の VPN、透過プロキシ、社内ゲートウェイが WASM ファイルを書き換えまたはブロック |
| 非標準 WebView | WeChat/DingTalk 内蔵ブラウザ、古いアプリ内埋め込みページ |
| デバイス管理設定 | 学校/会社の管理デバイス、Screen Time などの制限 |
プラットフォーム別トラブルシューティング
Windows(デスクトップ)
- Chrome / Edge の最新安定版(推奨 90 以上)を使用し、IE モードや「互換表示」を避けてください。
chrome://settings/systemを開き、ハードウェアアクセラレーションが有効になっていることを確認します(GPU スタックに関連し、一部の環境では WASM の読み込みにも影響します)。- グループポリシー(企業):IT が「JavaScript を無効化」や Web 機能の制限を設定している場合、WASM も無効になります。管理者に連絡し、
wasm-unsafe-evalまたは同等のポリシーが許可されているか確認してください。 - Windows ファミリーセーフティ / 保護者制限:アカウントが「子アカウント」でブラウザ機能が制限されている場合、管理者アカウントに切り替えるか、「Web ブラウジング制限」を調整して再試行してください。
macOS(デスクトップ)
- Safari 15 以上 または Chrome / Firefox の最新版を優先します。
- スクリーンタイム:コンテンツ制限 → Web コンテンツで、「許可された Web サイトのみ」に設定されている場合、スクリプト実行環境を間接的に制限する可能性があります。
- MDM 管理 Mac(会社支給デバイス):ブラウザ拡張機能や Web 機能を制限する設定プロファイルがないか確認します。
Linux(デスクトップ)
- ディストリビューションの公式チャネルまたはブラウザ公式サイトからインストールした Chrome / Firefox を使用し、古い Snap/Flatpak パッケージ版を避けてください。
- 社内ネットワークの Linux ワークステーションで HTTP プロキシが強制されている場合、プロキシが
.wasmのContent-Type: application/wasmをブロックしていないことを確認します。
iOS / iPadOS(モバイル)
- Safari または Chrome(iOS では実際 WebKit コア) で開き、アプリ内 WebView で直接使用するのは避けてください。
- スクリーンタイム → コンテンツとプライバシーの制限:「Web コンテンツの制限」をオフにするか、Any3D を許可リストに追加します。
- 企業の MDM デバイスでは JavaScript 機能の一部が無効化されている場合があり、IT に連絡が必要です。
Android(モバイル)
- Chrome の最新版を使用します。国内ブラウザは「高速/モダンコア」に切り替え、互換モードは使用しないでください。
- デジタルウェルネス / 保護者制限(Family Link など):ブラウザまたは不明なサイトが制限されていないか確認します。
- WeChat、DingTalk で開く場合 → 右上の「ブラウザで開く」をタップします。
ネットワーク、VPN と社内ネットワーク
| シナリオ | 推奨事項 |
|---|---|
| 会社の VPN | VPN を切断して比較テストします。一部の VPN は MITM または静的リソースをキャッシュし、WASM の検証失敗を引き起こすことがあります |
| 社内プロキシ / 透過ゲートウェイ | IT に *.wasm がブロックされていないか確認させます。必要に応じて Any3D ドメインをホワイトリストに追加します |
| 海外ノード / 分岐ルール | Any3D の静的リソースが直結または安定した経路を通過し、CDN ノードが誤った MIME を返さないようにします |
| ゼロトラストクライアント(ZTA) | 一部のクライアントが CSP を注入するため、wasm-unsafe-eval を許可する必要があります |
個人ユーザー:モバイルホットスポットや家庭ネットワークに切り替えて検証し、ネットワーク層の問題かどうかを素早く判断できます。
保護者制限とデバイス管理
- Microsoft ファミリーセーフティ / Google Family Link / Apple スクリーンタイム:「Web サイトのフィルタリング」「承認されたアプリのみ許可」が完全な Web 機能をブロックしていないか確認します。
- 学校/図書館の公共コンピュータ:Deep Freeze または最小限のブラウザ設定が有効な場合が多く、個人デバイスの使用を推奨します。
- 企業 Intune / Jamf 管理:ブラウザが古いバージョンにロックされたり、拡張機能以外のスクリプト機能が無効化される場合があります。IT に例外を申請するか、非管理ブラウザプロファイルを使用してください。
段階的な修正(汎用)
- シークレット/プライバシーウィンドウで再試行(拡張機能を除外)。
- ブラウザを更新し、最新安定版にして再起動します。
- ブラウザを切り替えて検証します:Chrome ↔ Edge ↔ Firefox ↔ Safari。
- IE 互換 / デュアルコア互換モードをオフにします。
- 拡張機能を個別に無効化します(広告ブロッカー、プライバシー、スクリプト関連を優先)。
簡易セルフテスト
開発者ツールの Console で以下を実行します:
typeof WebAssembly !== "undefined"
true が返则 WASM API が利用可能です。まだ false の場合、問題はブラウザまたはシステムポリシーにあり、Any3D ではありません。
まだ解決できない場合
- 記録:OS、ブラウザバージョン、VPN/社内ネットワークの有無、管理デバイスの有無。
- Any3D ページのフィードバック入力から上記情報を添えて送信します。
まとめ
WebAssembly の不足は、古いブラウザ、拡張機能の干渉、VPN/社内ネットワークによるブロック、企業または保護者ポリシーの制限で一般的です。プラットフォームごとに段階的に排除すれば、ほとんどの環境で復旧します。Any3D は WASM が利用できない場合にデグレードできません——ブラウザとアクセス環境の修正が唯一の可行解です。