Kris

WebGL2 が使えない?3Dプレビュー問題をプラットフォーム別に解決

トラブルシューティングブラウザ互換性WebGL2

見られる症状

プレビュー領域に「3Dプレビューが利用できません」と表示される、またはページが真っ白でモデルが表示されない。Any3D のオンラインプレビューは WebGL2 に依存し、GPUで3Dシーンをレンダリングします。WebGL2が利用できないとプレビューが起動しません。

よくある原因

原因典型的なシナリオ
ハードウェアアクセラレーションがオフブラウザまたはシステム設定でGPUが無効化
グラフィックドライバが古い/異常WindowsノートPCのデュアルGPU、Linuxのオープンソースドライバ
ブラウザのブラックリスト非常に古いGPUがブラウザのソフトウェアレンダリングリストに含まれる
リモートデスクトップ/仮想マシンRDP、VMでGPUパススルーなし
企業ポリシーGPOによるハードウェアアクセラレーション無効化、VDIで3Dアクセラレーションなし
WebView/古いカーネルLINE、Slack、古いアプリの内蔵ブラウザ
拡張機能の干渉Canvasフィンガープリント対策などの強制ブロック

プラットフォーム別の診断

Windows

  1. ハードウェアアクセラレーションを有効にする
    Chrome/Edge:設定 → システム → 「ハードウェアアクセラレーションが使用可能な場合は使用する」→ ブラウザ再起動。

  2. グラフィックドライバを更新する
    NVIDIA / AMD / Intel の公式サイトまたはWindows Updateから最新ドライバをインストール。ノートPCの場合は、GPUコントロールパネルでブラウザを「高パフォーマンス」に設定。

  3. グループポリシー/レジストリ(企業向け)
    IT部門がGPU合成を無効にするポリシーを設定している可能性あり。個人ユーザーは chrome://gpu で「Software only」が大量に表示されていないか確認。

  4. リモートデスクトップ
    オフィスPCにRDP接続している場合、WebGLは使えないことが多い——ローカルPCのブラウザでAny3Dを開くか、GPU対応のリモートソリューションを利用。

  5. ペアレンタルコントロール
    Windows ファミリーセーフティの子アカウントでは通常WebGLは制限されない。ただし、サードパーティの「子供向けブラウザ」を使っている場合は、Chrome/Edgeでテスト。

macOS

  1. Safari / Chrome 最新版;システム設定 → ディスプレイ → リフレッシュレート/解像度が正常であることを確認。
  2. 低電力モード ではGPUが動作を抑えられ、極端な場合WebGLに影響——電源に接続して再試行。
  3. スクリーンタイム は直接WebGLを禁止しない。MDMでグラフィック制限がかかっている場合はITに問い合わせ。

Linux

  1. プロプライエタリドライバ(NVIDIA)または新しいMesaを使用;chrome://gpu でGLの状態を確認。
  2. WaylandとX11のどちらか一方で失敗する場合、セッションを切り替えて比較。

iOS / iPadOS

  1. Safari はWebGL2のサポートが良好;システムを最新に保つ。
  2. 低電力モード でパフォーマンスが制限され、プレビューがカクついたり失敗する——充電後に再試行。
  3. アプリ内WebView → Safariで開く
  4. 学校管理のiPadで「カメラ/ファイル」が禁止されていてもWebGLには影響しないが、システムアップデートが禁止されるとカーネルが古くなり問題が発生する。

Android

  1. Chromeを更新;開発者オプション → 強制的にGPUレンダリングを有効にする(一部の古い機種で効果あり、新しいシステムではデフォルトで有効の場合あり)。
  2. 国内メーカーのブラウザは互換性の都合でWebGL2が使えないことが多い → Chromeを使用。
  3. 省電力モード でGPUが制限される——オフにして再試行。

ネットワーク、VPN、企業内ネットワーク

WebGL2はローカルGPUのAPIであり、通常VPNの直接的な影響は受けません。ただし以下のケースに注意:

シナリオ説明
企業VDI(Citrix/VMware)GPUパススルーが有効でない場合WebGLは不可。IT部門にvGPUの有効化を依頼するか、ローカルブラウザを使用
VPNで強制的にブラウザ拡張機能がインストールされる拡張機能がWebGLコンテキストを妨害する可能性あり
社内ネットワークでIE/旧Edgeのみ許可WebGL2非対応。最新のChromiumベースブラウザに切り替えが必要

ペアレンタルコントロールと公共環境

  • 図書館/学校のPC:制限されたブラウザやGPU非搭載の可能性あり——自分のノートPCで検証。
  • Family Link によるChromeバージョン制限:PlayストアからChromeをアップデート可能。

段階的な修復手順(共通)

  1. chrome://gpu(Chrome/Edge)または about:support → グラフィックスを開き、WebGL2が Hardware accelerated と表示されているか確認。
  2. ハードウェアアクセラレーションを有効にし、ドライバを更新し、ブラウザとシステムを再起動。
  3. シークレットウィンドウで拡張機能を排除。
  4. 別のブラウザ/別のデバイスでクロスチェック。

クイックセルフチェック

(() => {
  const c = document.createElement("canvas");
  return c.getContext("webgl2") !== null;
})();

false が返ればWebGL2コンテキストを作成できません。

また、WebGL Report(外部サイト)にアクセスして詳細な機能を確認することもできます。

OffscreenCanvas との関係

テクスチャ圧縮のWorkerパスでは OffscreenCanvas + WebGL2 も必要です。プレビューは正常に表示されていて、下部に黄色いWorker警告だけが出ている場合は、先に OffscreenCanvas ガイド を参照。プレビュー自体が失敗している場合は、この記事が主な対処法となります。

まとめ

WebGL2が利用できない主な原因は GPU/ドライバ/ハードウェアアクセラレーション の問題です。企業VDI、リモートデスクトップ、古いWebViewもよくあるケースです。プラットフォームに応じてアクセラレーションを有効にし、ドライバを更新し、ローカルブラウザでアクセスすれば、ほとんどの3Dプレビューが復旧します。

応援する