·Any3D Team
Web Worker が使用できない場合:プラットフォームと環境別にトラブルシューティング
troubleshootingbrowser-compatibilityweb-worker
見られる症状
Any3D の下部に黄色い警告が表示される:「現在のブラウザは Web Worker をサポートしていません」。プレビューはまだ使えるかもしれませんが、大ファイルの処理でページがフリーズしやすいため、テクスチャ圧縮や画像からモデルへの変換などの Worker パスが有効になりません。
Web Worker は時間のかかる計算をバックグラウンドスレッドで実行します。Any3D のテクスチャ圧縮や一部の変換フローは、Worker + OffscreenCanvas + createImageBitmap の3つのコンポーネントに依存しています。
一般的な原因
| 原因 | 典型的なシナリオ |
|---|---|
| セキュアコンテキストでない | file:// で開く、HTTP の社内ネットワークページ(localhost ではない) |
| ブラウザ / WebView が古い | 旧バージョンのシステムブラウザ、アプリ内埋め込みページ |
| CSP 制限 | 企業ポータル iframe、ゼロトラストクライアントによる worker-src の注入 |
| 拡張機能によるブロック | プライバシープラグインが Worker または blob: URL を阻止 |
| ネットワークキャッシュの異常 | プロキシ/VPN が不完全な Worker スクリプトを返す |
| デバイスの管理 | 管理プロファイルがバックグラウンドスクリプトを無効にしている |
プラットフォーム別トラブルシューティング
Windows
- 必ず HTTPS(
https://any3d.cc)でアクセスし、ローカル HTML ファイルは使用しないでください。 - Edge エンタープライズポリシー:
Computer Configuration → Administrative Templates → Microsoft Edgeで、Worker またはサードパーティ Cookie を制限していないか確認します(一部の Worker ロードに間接的な影響)。 - Windows ファミリーセーフティ:子アカウントの Web 制限が Worker の作成に失敗する原因になることがあります。
macOS
- Safari / Chrome はいずれも macOS 12+ かつ最新のブラウザバージョンが必要です。
- スクリーンタイム → コンテンツとプライバシー → 「成人向けサイトの制限」またはカスタムフィルターが有効な場合、Worker スクリプトのドメインに誤って影響する可能性があります。
- 会社の MDM プロファイルが「クロスサイトトラッキング以外の」スクリプト機能を無効にしている場合は、IT 部門に連絡してください。
Linux
- アクセス URL が HTTPS であることを確認します。企業の Squid プロキシが
blob:およびworker-src関連のリクエストを許可する必要があります。
iOS / Android
- 微信/钉钉 の組み込みブラウザで大ファイルの処理を行わないでください。システムブラウザで開いてください。
- iOS の低消費電力モード は通常 Worker を無効にしませんが、古い WebKit では API が欠けている場合があります – システムを更新してください。
- Android の WebView バージョン が古い(システム WebView が更新されていない)と、Worker が使用できなくなります:Play Store で「Android System WebView」を更新してください。
ネットワーク、VPN と社内ネットワーク
| シナリオ | 説明 |
|---|---|
| 会社の VPN | 一部の VPN は HTTPS 解析を強制し CSP を注入するため、IT 部門が Worker を許可する必要があります |
| 社内ネットワーク SSO ポータル iframe | 外部ページの CSP が worker-src blob: を禁止している場合、埋め込みページで個別に設定するか、新しいタブで Any3D を開く必要があります |
| リバースプロキシ | Nginx/ゲートウェイの設定ミスにより、Worker スクリプトの MIME タイプが正しくないことがあります |
| 保護者ルーターの DNS フィルタリング | Worker では希ですが、サイト全体が HTTP ミラーよりダウングレードされた場合、Worker は機能しなくなります |
自己テスト:VPN を切断し、4G/5G ホットスポットに切り替えて、警告が消えるか確認します。
企業 CSP 参考情報(IT 向け)
Any3D が iframe で埋め込まれる場合、以下を許可することをお勧めします:
worker-src 'self' blob:;
script-src 'self' 'unsafe-eval' blob:;
個人ユーザーは手動で CSP を変更する必要はありません。
段階的な修正手順(汎用)
- HTTPS でアクセスしていることを確認し、ページを更新します(Ctrl+F5 / Cmd+Shift+R)。
- シークレットウィンドウで拡張機能の影響を除外します。
- ブラウザと(Android の)システム WebView を更新します。
- 新しいタブで直接 Any3D を開き、企業ポータルの iframe 内に埋め込むのを避けてください。
簡易自己テスト
typeof Worker !== "undefined"
true が返されるのは API が存在するだけであり、Any3D は OffscreenCanvas と createImageBitmap がすべて揃って初めて Worker パスを完全に実行します。
Worker がない場合の影響
| 機能 | 影響 |
|---|---|
| 頂点圧縮(Draco など) | 通常はまだ使用可能(メインスレッド + WASM) |
| テクスチャ / KTX2 圧縮 | Worker パスが使用できず、大ファイルでフリーズしやすい |
| 画像からモデルへの変換 | 動作が低下するか、性能が著しく低下する可能性があります |
まとめ
Web Worker の警告は、主に非 HTTPS、古い WebView、企業 CSP/VPN、拡張機能によるブロックが原因です。プラットフォームに合わせてブラウザを更新し、ネットワークを変えて検証し、IT 部門に iframe/CSP を確認してもらうことで、通常はバックグラウンド処理能力を復旧できます。