AI Development

2026 visionOS 27 WebXR тормозит: как Three.js удерживать стабильную частоту кадров и избегать сбоев

2026 visionOS 27 WebXR тормозит: как Three.js удерживать стабильную частоту кадров и избегать сбоев

Тормоза WebXR в visionOS 27 лучше всего устраняются не переключением на WebGPU, а последовательностью «измерить — сжать ресурсы — снизить Draw Call и пиксельную нагрузку — затем сравнить WebGL и WebGPU». Такой порядок подходит проектам, где уже воспроизводится проблема на Apple Vision Pro и требуется сохранить рабочий резервный путь.

Эта статья рассчитана на фронтенд-разработчиков, превращающих обычную Three.js-страницу в WebXR-опыт для Vision Pro. Она также пригодится техническим руководителям, которым нужно отделить дефект ассетов от ограничений рендеринга, и удалённым командам без постоянного набора Mac, Safari и симулятора visionOS.

Последние выводы следует перепроверять после обновлений Safari 27.x, visionOS 27.x, WebKit или Three.js. Дата подготовки материала — 16 сентября 2026 года; сведения о WebXR и WebGPU сверены по материалу WebKit о возможностях Safari 26.2, документации Three.js и заметкам Safari Technology Preview.

Сначала разделите просадку кадров на четыре разных дефекта

Одинаковое слово «тормозит» скрывает разные симптомы. До оптимизации полезно записать короткий сценарий: загрузка страницы, запуск WebXR, переход в иммерсивный режим, движение головы, открытие тяжёлого объекта, выход и повторный вход.

Наблюдение Что измерять Наиболее вероятный слой
Низкая плавность уже в обычной странице frame time, количество объектов, вызовы отрисовки CPU сцены или базовый WebGL-пайплайн
Резкое ухудшение после входа в WebXR frame time до и после сессии, размеры render target разрешение, стереорендеринг, постобработка
Постепенное ухудшение после повторных входов память, renderer.info, жизненный цикл ресурсов утечка Texture, Geometry, Material или ImageBitmap
Чёрный экран и WebGL Context Lost консоль, шаг воспроизведения, пик загрузки потеря графического контекста или чрезмерная нагрузка
Плавность меняется после движения камеры тени, прозрачность, raycast, анимации динамическая часть сцены и главный поток

В Safari Web Inspector нужно смотреть консоль, кадры, сеть и признаки потери контекста. Для подключения к visionOS используется официальная инструкция Apple по инспектированию WebXR и страниц visionOS. Инструмент не сообщает «правильный» предел памяти вкладки, зато помогает связать ошибку с конкретным действием.

renderer.info.render.calls показывает число вызовов отрисовки, renderer.info.render.triangles — объём геометрии, а renderer.info.programs помогает заметить чрезмерное количество вариантов шейдеров. Эти показатели нужно записывать до запуска WebXR, внутри сессии и после выхода. Одно измерение после загрузки ничего не доказывает.

Сценарий считается воспроизводимым, если команда фиксирует:

  • модель устройства и версию visionOS;
  • Safari и версию Three.js;
  • режим WebGL или WebGPU;
  • размер viewport и включённые эффекты;
  • действие, после которого появляется просадка;
  • результат после повторного входа в ту же сцену.

Текстуры и освобождение ресурсов определяют давление на память

Фиксированный объём памяти, доступный одной вкладке Safari на visionOS, официально не опубликован. Поэтому утверждение о «стене в X гигабайт» нельзя использовать как универсальное объяснение. Реальная нагрузка зависит от размеров текстур, формата пикселей, mip-уровней, числа одновременно живых вариантов и внутренних копий, создаваемых декодером или рендерером.

Для предварительной оценки используется не обещанный лимит, а состав бюджета. В нём отдельно записываются:

  • ширина и высота каждой текстуры;
  • наличие mip-уровней;
  • цветовой формат и прозрачность;
  • число материалов, ссылающихся на ресурс;
  • необходимость render target;
  • продолжительность одновременного пребывания ассетов в сцене.

KTX2 и BasisU полезны, когда проект содержит много больших изображений. KTX2Loader выбирает поддерживаемый сжатый формат через Basis Universal, но подключение загрузчика само по себе не является доказательством экономии памяти. В Three.js порядок настройки описан в документации KTX2Loader.

const ktx2Loader = new KTX2Loader()
  .setTranscoderPath('/basis/')
  .detectSupport(renderer);

const textureLoader = new THREE.TextureLoader();
const compressed = await ktx2Loader.loadAsync('/assets/scene_color.ktx2');

compressed.colorSpace = THREE.SRGBColorSpace;
material.map = compressed;

После этого следует проверить фактическое поведение. Сравниваются размер загрузки, время декодирования, renderer.info, повторный вход в сцену и появление Context Lost. В некоторых материалах дополнительные mip-уровни и прозрачность меняют результат, поэтому «KTX2 всегда решает проблему» — такой вывод слишком широк.

Освобождение ресурсов должно быть симметричным загрузке. При смене сцены удаляются ссылки на объекты, затем вызываются dispose() для геометрии, материалов, текстур и render target. Для сложных случаев полезно сверяться с руководством Three.js по освобождению объектов.

function disposeObject(root) {
  root.traverse((node) => {
    if (node.geometry) node.geometry.dispose();

    const materials = Array.isArray(node.material)
      ? node.material
      : [node.material];

    for (const material of materials) {
      if (!material) continue;

      for (const value of Object.values(material)) {
        if (value && value.isTexture) value.dispose();
      }

      material.dispose();
    }
  });
}

ImageBitmap требует отдельного закрытия, если приложение владеет объектом:

if (bitmap && typeof bitmap.close === 'function') {
  bitmap.close();
}

После очистки старые ссылки нельзя оставлять в кэше маршрутизатора, глобальном хранилище или обработчиках событий. Проверка выполняется циклом: загрузить сцену, выйти, удалить её, загрузить снова. Если число ресурсов или время кадра растёт от цикла к циклу, проблема уже не в разовом размере GLB.

Draw Call и главный поток: маленькие объекты бывают дороже большого файла

Размер GLB на диске не показывает стоимость каждого кадра. Тысячи отдельных Mesh создают вызовы отрисовки, переключения материалов и работу JavaScript. Поэтому сначала фиксируются calls, triangles и программы, а уже после этого меняются модели.

Признак в renderer.info Что проверить Предпочтительное действие
Высокое число calls, умеренное число треугольников множество одинаковых объектов InstancedMesh
Растёт triangles при небольшом числе объектов чрезмерная детализация LOD, упрощённые версии, удаление невидимых частей
Много программ варианты материалов и defines унификация материалов, сокращение переключений
Высокая стоимость прозрачных поверхностей стекло, UI, частицы уменьшить перекрытия и площадь прозрачности
Тяжёлый кадр при движении света динамические тени снизить размер shadow map и число источников

Для повторяющейся геометрии применяется InstancedMesh:

const mesh = new THREE.InstancedMesh(
  sharedGeometry,
  sharedMaterial,
  instanceCount
);

const transform = new THREE.Object3D();

for (let index = 0; index < instanceCount; index += 1) {
  transform.position.set(index * 0.4, 0, -2);
  transform.updateMatrix();
  mesh.setMatrixAt(index, transform.matrix);
}

mesh.instanceMatrix.needsUpdate = true;
scene.add(mesh);

Инстансинг помогает, когда геометрия и материал действительно общие. Он не устраняет стоимость сложного фрагментного шейдера, прозрачности или большого количества пикселей. Для статичных объектов можно оценить объединение геометрии, но после объединения ухудшается выборочное скрытие, самостоятельная анимация и управление материалами.

Одновременно проверяются операции, которые не видны в счётчике Draw Call:

  • создание Vector3, массивов и временных объектов внутри render;
  • полный raycast по сцене на каждом кадре;
  • пересчёт матриц для неподвижных объектов;
  • обновление скелета без видимой анимации;
  • сортировка прозрачных элементов;
  • генерация теней для объектов, которые не влияют на итоговую картинку.

Сцена может получить меньше вызовов и всё равно остаться медленной, если главный поток занят анимацией или проверкой пересечений. Диагностика должна разделять CPU и GPU: отключение теней, постобработки и raycast по одному параметру показывает, какой слой отвечает за frame time.

Пиксельная нагрузка растёт вместе с разрешением и эффектами

В стереорежиме кадр требует обработки для двух представлений. Дополнительную стоимость создают высокий devicePixelRatio, MSAA, большие shadow map, прозрачные слои и несколько post-processing Pass. Поэтому ограничение Draw Call не заменяет контроль площади рендера.

Настройка Почему она опасна Как проверять
devicePixelRatio без верхней границы количество фрагментов растёт быстрее ожидаемого временно задать консервативный максимум
MSAA дополнительные выборки и память render target сравнить включённый и выключенный режим
тени высокого разрешения отдельные проходы и большая карта глубины отключить только тени
прозрачные панели повторная обработка перекрывающихся пикселей уменьшить площадь и число слоёв
bloom, SSAO и другие Pass полные проходы по экрану отключать по одному

Динамическое качество лучше постоянного ухудшения для всех устройств. Пример упрощённого регулятора:

let quality = 1.0;
let slowFrames = 0;
let fastFrames = 0;

function updateQuality(frameTimeMs) {
  if (frameTimeMs > 22) {
    slowFrames += 1;
    fastFrames = 0;
  } else if (frameTimeMs < 16) {
    fastFrames += 1;
    slowFrames = 0;
  }

  if (slowFrames >= 8) {
    quality = Math.max(0.65, quality - 0.1);
    slowFrames = 0;
  }

  if (fastFrames >= 20) {
    quality = Math.min(1.0, quality + 0.05);
    fastFrames = 0;
  }

  renderer.setPixelRatio(
    Math.min(window.devicePixelRatio, quality)
  );
}

Пороговые значения в этом примере — параметры алгоритма, а не универсальная характеристика visionOS. Их нужно подобрать по сцене и проверить на реальном устройстве. Важно менять один фактор за тест. Если одновременно уменьшить разрешение, выключить тени и заменить материалы, команда не узнает, что именно дало результат.

Render target также нельзя оставлять без контроля. В Three.js он хранит цветовые и иногда глубинные буферы, поэтому при уничтожении пользовательского эффекта нужно освободить его явно. Общие принципы работы с такими объектами описаны в руководстве Three.js по RenderTarget.

Условия выбора WebGL и WebGPU

Safari 26.2 добавил поддержку WebGPU для WebXR на visionOS. Это важное изменение, но оно не означает, что любой проект Three.js сразу станет быстрее. Сценарий с готовыми PBR-материалами может вести себя иначе, чем проект с ShaderMaterial, onBeforeCompile, нестандартными uniform или цепочкой постобработки.

Проверка должна выполняться по возможностям:

const supportsWebGPU =
  'gpu' in navigator &&
  typeof THREE.WebGPURenderer === 'function';

let renderer;

if (supportsWebGPU) {
  try {
    renderer = new THREE.WebGPURenderer({ antialias: false });
    await renderer.init();
  } catch (error) {
    console.warn('WebGPU недоступен, используется WebGL', error);
    renderer = new THREE.WebGLRenderer({ antialias: false });
  }
} else {
  renderer = new THREE.WebGLRenderer({ antialias: false });
}

Это не должно быть единственным тестом. Нужно проверить создание XR-сессии, материалы, освещение, resize, render target, контроллеры и корректное завершение сеанса. Документация WebGPURenderer отдельно подчёркивает, что миграция затрагивает архитектуру рендера.

Metal нельзя представить как универсальный переключатель в JavaScript. WebKit и операционная система могут использовать Metal внутри графического стека, но веб-приложение не получает кнопку «включить Metal вместо WebGL». Поэтому попытка найти такой флаг только запутает диагностику.

Условия возврата к WebGL

  • Если WebGPU не обнаружен — используется WebGL.
  • Если renderer.init() завершается ошибкой — используется WebGL.
  • Если ключевой ShaderMaterial не отрисовывается — WebGL остаётся рабочим резервом.
  • Если WebGPU уменьшает frame time, но ломает XR-функцию или постобработку — результат не считается готовым к выпуску.
  • Если обе реализации стабильны, выбор делается по измерениям каждой целевой сцены, а не по названию API.

Три диагностические матрицы для середины проекта

Первая матрица должна сравнивать не только режимы, но и момент сценария:

Состояние WebGL WebGPU Что записать
обычная страница базовый frame time инициализация ошибки и renderer.info
вход в WebXR frame time в сессии frame time в сессии разрешение и эффекты
тяжёлая сцена текстуры и Draw Call текстуры и Draw Call пик нагрузки
повторный вход состояние после очистки состояние после очистки признаки утечки
длительный прогон стабильность стабильность потеря контекста

Вторая матрица нужна для ресурсов:

Вариант ассета Проверка Критерий принятия
обычная PNG/JPEG-текстура загрузка и повторный вход нет роста ресурсов
KTX2/BasisU декодирование и формат нет артефактов, нагрузка ниже или стабильнее
текстура с mip-уровнями качество на расстоянии приемлемая детализация без лишней памяти
render target создание и удаление объект не накапливается после выхода

Третья матрица фиксирует решение по среде:

Среда Что допустимо проверять Что нельзя считать доказанным
Mac с Safari загрузка, консоль, Web Inspector итоговую частоту кадров Vision Pro
симулятор visionOS разрешения, маршруты, базовую совместимость поведение GPU реального устройства
Apple Vision Pro frame time, контекст, длительный прогон перенос результата на все версии без повторной проверки

Командам, которым нужен отдельный набор сред, стоит заранее описать правила доступа и завершения сессии в разделе управления ProxyMac. Для расчёта регулярных расходов пригодится страница условий аренды ProxyMac. Такая удалённая среда подходит для конвертации ассетов, сборок, инспектирования Safari и предварительной проверки симулятора, но не заменяет физический Vision Pro.

FAQ по сбоям Safari и WebXR

Почему сцена Three.js на Vision Pro внезапно теряет кадры в Safari?

Причина обычно не сводится к одной настройке Safari. Просадка может появляться при переходе в иммерсивный режим, росте числа вызовов отрисовки, загрузке mip-уровней, прозрачных материалах, тенях или работе основного потока. Сначала сравните кадры и frame time в обычном режиме, WebXR-сеансе и на реальном устройстве, затем меняйте только один параметр.

Что проверять первым при ошибке WebGL Context Lost в WebXR?

Сначала нужно сохранить точный шаг воспроизведения, состояние renderer.info и сообщения Safari Web Inspector. Затем проверяются повторный вход в сцену, освобождение Texture, Geometry, Material, RenderTarget и ImageBitmap, а также пиковая нагрузка текстур. Фиксированный лимит памяти для одной вкладки официально не опубликован, поэтому вывод делают по повторяемому тесту, а не по слухам.

Снижают ли KTX2 и BasisU риск сбоев веб-сцены на Vision Pro?

KTX2 с Basis Universal обычно сокращает объём передаваемых текстурных данных и может уменьшить давление на память, но сам контейнер не гарантирует меньший расход GPU-памяти во всех сценариях. Нужно убедиться, какой формат выбрал декодер, сравнить renderer.info и повторить тест после нескольких циклов входа и выхода из сцены.

Что выбрать для WebXR в visionOS — WebGL или WebGPU?

WebGPU стоит рассматривать как проверяемый вариант, а не как автоматическое ускорение. Safari 26.2 добавил поддержку WebGPU для WebXR на visionOS, однако совместимость WebGPURenderer с ShaderMaterial, onBeforeCompile и постобработкой требует отдельной проверки. Рабочий релиз должен иметь feature detection и резервный путь через WebGL.

Как тестировать производительность Safari WebXR без Vision Pro?

Mac с Safari и симулятором visionOS подходит для проверки загрузки, разрешений, переходов и базовой совместимости, но не для окончательной оценки частоты кадров и устойчивости графического контекста. Симулятор не заменяет физическое устройство. Для удалённой команды Mac-среда помогает подготовить сборку и повторяемый сценарий, а финальный приём выполняется на Apple Vision Pro.

Порядок приёмки перед публикацией

Если выполняется хотя бы одно условие, сначала остаётся WebGL: WebGPU не инициализируется, отсутствует нужная XR-функция, ломается пользовательский шейдер или не работает постобработка. Если WebGPU проходит эти проверки, запускается парное сравнение на одинаковых ассетах и одинаковом сценарии.

Порядок проверки должен быть таким:

  1. Зафиксировать версии Safari, visionOS, Three.js и режим рендера.
  2. Сохранить базовые значения frame time, calls, triangles и programs.
  3. Сжать самые тяжёлые текстуры и проверить KTX2/BasisU на артефакты.
  4. Повторить вход и выход из сцены, освобождая все пользовательские ресурсы.
  5. Сократить отдельные Mesh через InstancedMesh или аккуратное объединение статичной геометрии.
  6. По одному проверить тени, прозрачность, MSAA, devicePixelRatio и постобработку.
  7. Включить динамическое качество только после получения исходной контрольной точки.
  8. Сравнить WebGL и WebGPU через feature detection.
  9. Выполнить длительный прогон с повторным входом в WebXR.
  10. Повторить финальный сценарий на Apple Vision Pro, а не только в симуляторе.

Для команды, которая уже использует Windows или Linux как основной контур, браузерная удалённая среда снимает часть проблем с доступом к Safari, Xcode и инструментам WebKit, но не превращает симулятор в замену устройству. Собственная рабочая станция оправдана при постоянной разработке и тяжёлых сборках; аренда рациональнее для временного проекта, миграции ассетов, проверки версии Safari или короткого регрессионного цикла.

Именно поэтому текущая схема без доступного Mac часто имеет три слабых места: тесты выполняются на неподходящем браузере, версии Safari и Xcode не совпадают у участников, а повторную проверку после очистки ресурсов откладывают до самого релиза. ProxyMac может дать удалённой команде Mac-среду для конвертации Three.js-ассетов, сборки и предварительного WebXR-тестирования. Но итоговый вердикт по кадрам, потерям контекста и длительной устойчивости всё равно должен быть записан на реальном Apple Vision Pro.

Тестируйте WebXR на выделенном Mac с ProxyMac

Проверяйте производительность Three.js в полноценной удалённой среде с выделенными ресурсами без конкуренции за вычислительную мощность.
Подключайтесь к Mac через SSH или VNC прямо из браузера и анализируйте просадки кадров, загрузку GPU и стабильность WebXR.