WebGL2 недоступен? Исправление 3D-предпросмотра по платформам

Что вы видите

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

Частые причины

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

Диагностика по платформам

Windows

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

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

3. Групповые политики / реестр (корпоративная среда)
   IT-отдел может отключать 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, обратитесь к IT.

Linux

1. Проприетарный драйвер (NVIDIA) или свежая Mesa; состояние GL смотрите в chrome://gpu.
2. Если один из сеансов Wayland или X11 работает некорректно, попробуйте переключиться на другой.

iOS / iPadOS

1. Safari хорошо поддерживает WebGL2; поддерживайте систему в актуальном состоянии.
2. Режим энергосбережения может ограничивать производительность, вызывая торможение или сбой предпросмотра — зарядите устройство и повторите.
3. Встроенный WebView внутри приложения → откройте страницу в Safari.
4. На iPad, управляемом учебным заведением, запрет «Камера/Файлы» не влияет на WebGL, но запрет обновления системы приводит к устаревшему ядру WebKit.

Android

1. Обновите Chrome; включите Параметры разработчика → Принудительный рендеринг GPU (на некоторых старых моделях помогает, в новых системах может быть включено по умолчанию).
2. Браузеры со встроенным «режимом совместимости» часто не имеют WebGL2 — используйте Chrome.
3. Энергосбережение ограничивает GPU — отключите его и повторите.

Сеть, VPN и корпоративный интранет

WebGL2 — локальный GPU API, напрямую VPN на него обычно не влияет. Но обратите внимание на следующие сценарии:

Сценарий	Пояснение
Корпоративный VDI (Citrix/VMware)	Без проброса GPU WebGL недоступен; нужен vGPU от IT или локальный браузер
VPN принудительно устанавливает расширения	Расширения могут нарушать создание WebGL-контекста
Внутренняя сеть допускает только IE / старый Edge	WebGL2 отсутствует; нужен современный браузер на Chromium

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

• ПК в библиотеке / школе: возможен браузер с урезанными функциями или без дискретной графики — попробуйте на личном ноутбуке.
• Google Family Link ограничивает версию Chrome: разрешите обновление Chrome из Play Store.

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

1. Откройте chrome://gpu (Chrome/Edge) или about:support → Graphics и проверьте, указан ли 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-предпросмотр восстанавливается.