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 проходит эти проверки, запускается парное сравнение на одинаковых ассетах и одинаковом сценарии.
Порядок проверки должен быть таким:
- Зафиксировать версии Safari, visionOS, Three.js и режим рендера.
- Сохранить базовые значения frame time,
calls,trianglesиprograms. - Сжать самые тяжёлые текстуры и проверить KTX2/BasisU на артефакты.
- Повторить вход и выход из сцены, освобождая все пользовательские ресурсы.
- Сократить отдельные Mesh через
InstancedMeshили аккуратное объединение статичной геометрии. - По одному проверить тени, прозрачность, MSAA,
devicePixelRatioи постобработку. - Включить динамическое качество только после получения исходной контрольной точки.
- Сравнить WebGL и WebGPU через feature detection.
- Выполнить длительный прогон с повторным входом в WebXR.
- Повторить финальный сценарий на 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.