WebGL2 недоступен? Пошаговое устранение проблем для 3D-превью по платформам

Симптомы

В области превью отображается сообщение «3D-превью недоступно», или страница пуста, модель не отображается. Онлайн-превью Any3D работает на основе рендеринга 3D-сцен в GPU через WebGL2; если WebGL2 недоступен, превью не запустится.

Типичные причины

Причина	Типичные сценарии
Отключено аппаратное ускорение	В настройках браузера или системы отключён GPU
Устаревший/нестабильный драйвер видеокарты	Ноутбуки с двумя видеокартами (Windows), открытые драйверы Linux
Чёрный список браузера	Очень старые видеокарты попадают в список программного рендеринга
Удалённый рабочий стол / виртуальная машина	RDP, VM без пропуска GPU
Корпоративная политика	GPO запрещает аппаратное ускорение, VDI без 3D-ускорения
WebView / старое ядро браузера	WeChat, DingTalk, устаревшие приложения
Конфликт расширений	Плагины для защиты Canvas-отпечатков

Пошаговое устранение по платформам

Windows

1. Включите аппаратное ускорение
   Chrome/Edge: Настройки → Система → «Использовать аппаратное ускорение (если доступно)» → перезапустите браузер.

2. Обновите драйвер видеокарты
   Установите последний драйвер с сайта NVIDIA / AMD / Intel или через Windows Update. В настройках видеокарты ноутбука задайте для браузера режим «Высокая производительность».

3. Групповая политика / реестр (корпоративная среда)
   Отдел ИТ может отключить GPU-композитинг через политики. Пользователь может проверить chrome://gpu — если много строк «Software only», проблема в политике.

4. Удалённый рабочий стол
   При RDP-подключении к рабочему компьютеру WebGL часто недоступен — откройте Any3D в локальном браузере или используйте удалённое решение с поддержкой GPU.

5. Родительский контроль
   Дочерние аккаунты Windows Family Safety обычно не блокируют WebGL; если используется сторонний «детский браузер», попробуйте Chrome/Edge.

macOS

1. Используйте последнюю версию Safari / Chrome; в «Настройках системы» → Монитор проверьте частоту обновления/разрешение.
2. В режиме энергосбережения GPU снижает производительность, что может повлиять на WebGL — подключите зарядное устройство и повторите попытку.
3. Ограничения времени экрана не блокируют WebGL напрямую; ограничения графики через MDM требуют обращения к ИТ.

Linux

1. Установите проприетарный драйвер (NVIDIA) или обновите Mesa; проверьте статус GL в chrome://gpu.
2. Если WebGL не работает в 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 недоступен; нужно включить vGPU или использовать локальный браузер
VPN принудительно устанавливает расширения браузера	Расширения могут конфликтовать с контекстом WebGL
Внутренняя сеть разрешает только IE/устаревший Edge	WebGL2 недоступен; необходим современный Chromium-браузер

Родительский контроль и общедоступные среды

• ПК в библиотеке/школе: могут использоваться ограниченные браузеры или отсутствовать выделенная видеокарта — проверьте на своём ноутбуке.
• Family Link ограничивает версию Chrome: разрешите обновление Chrome через Play Market.

Пошаговое исправление (универсальное)

1. Откройте chrome://gpu (Chrome/Edge) или about:support → Графика и проверьте, включено ли Hardware accelerated для WebGL2.
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-превью в большинстве случаев.