Any3DAny3D
·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

  1. 必ず HTTPShttps://any3d.cc)でアクセスし、ローカル HTML ファイルは使用しないでください。
  2. Edge エンタープライズポリシーComputer Configuration → Administrative Templates → Microsoft Edge で、Worker またはサードパーティ Cookie を制限していないか確認します(一部の Worker ロードに間接的な影響)。
  3. Windows ファミリーセーフティ:子アカウントの Web 制限が Worker の作成に失敗する原因になることがあります。

macOS

  1. Safari / Chrome はいずれも macOS 12+ かつ最新のブラウザバージョンが必要です。
  2. スクリーンタイム → コンテンツとプライバシー → 「成人向けサイトの制限」またはカスタムフィルターが有効な場合、Worker スクリプトのドメインに誤って影響する可能性があります。
  3. 会社の MDM プロファイルが「クロスサイトトラッキング以外の」スクリプト機能を無効にしている場合は、IT 部門に連絡してください。

Linux

  1. アクセス URL が HTTPS であることを確認します。企業の Squid プロキシが blob: および worker-src 関連のリクエストを許可する必要があります。

iOS / Android

  1. 微信/钉钉 の組み込みブラウザで大ファイルの処理を行わないでください。システムブラウザで開いてください。
  2. iOS の低消費電力モード は通常 Worker を無効にしませんが、古い WebKit では API が欠けている場合があります – システムを更新してください。
  3. 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 を変更する必要はありません。

段階的な修正手順(汎用)

  1. HTTPS でアクセスしていることを確認し、ページを更新します(Ctrl+F5 / Cmd+Shift+R)。
  2. シークレットウィンドウで拡張機能の影響を除外します。
  3. ブラウザと(Android の)システム WebView を更新します。
  4. 新しいタブで直接 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 を確認してもらうことで、通常はバックグラウンド処理能力を復旧できます。

応援する