WebXR

Vision SE ещё не анонсирована: с какого уровня начинать диагностику сбоев WebXR в Safari? 2026

Страница WebXR в Safari белеет, перестаёт рисовать сцену или загружается заново?

Быстрое решение: сначала проверьте ошибки JavaScript и загрузку ресурсов, затем выясните, теряется ли WebGL-контекст или перезапускается вся вкладка. Vision SE и изменение её лимитов памяти не подтверждены Apple, поэтому диагностику вылетов страниц Vision SE нельзя начинать с предположения об OOM.

Эта инструкция пригодится разработчикам WebXR и Three.js, которым нужно локализовать белый экран, прерывание рендеринга или потерю контекста в Safari.
Она также адресована дизайнерам Spline, которым важно отделить проблемы сцены от ограничений среды, и руководителям проектов, выбирающим между исправлением, снижением сложности и переносом публикации.

Обновлено 18 октября 2026 года; официальные сведения сверены с материалами Apple Developer, WebKit, W3C и документацией Three.js, ссылки приведены в соответствующих разделах.

Сначала отделите неподтверждённую модель устройства от проверяемых фактов

В проверенных официальных материалах Apple и WebKit не найдено подтверждения существования Vision SE, её поставок, изменения объёма объединённой памяти или специального лимита памяти Safari на вкладку в visionOS 3.1. Поэтому рассказы о том, что устройство якобы вызывает сбой WebXR из-за уменьшенной памяти, следует считать неподтверждёнными, пока не появятся официальные сведения или воспроизводимые результаты проверки на реальном устройстве.

При этом есть проверяемые технические ориентиры. Apple описывает подключение Mac к веб-страницам visionOS через Safari Web Inspector. WebKit отдельно публикует сведения о развитии WebXR в Safari; например, в описании Safari 26.2 указана поддержка WebGPU для WebXR. Это сообщение о возможностях платформы, а не подтверждение конкретной конфигурации Vision SE и не объяснение причины отдельного сбоя.

Для анализа полезно сверять поведение страницы со спецификациями: спецификация WebXR Device API описывает API взаимодействия с XR-устройствами, а спецификация WebGL — правила работы контекста WebGL. Ни одна из них сама по себе не доказывает, что конкретная сцена стабильна на конкретном устройстве.

Подтверждена ли Vision SE официально? В проверенных на дату обновления материала публикациях Apple и WebKit подтверждения не найдено. Если в сообщениях СМИ или сообществах упоминаются устройство, его поставки либо особые лимиты Safari, отделяйте такие заявления от официальной документации и не используйте их как установленную причину сбоя.

Различайте три явления: ошибка JavaScript или загрузки ресурсов; потеря WebGL-контекста при продолжающей работать странице; перезагрузка либо закрытие самой вкладки. Белый экран — описание симптома, а не диагноз. Без системного журнала или проверки на целевом устройстве надёжно назвать причиной OOM нельзя.

Сначала проверьте Console и Network через Web Inspector

Для диагностики страницы на visionOS начните с подключения Safari Web Inspector на Mac. Руководство Apple по проверке веб-страниц visionOS описывает этот путь. Названия пунктов интерфейса могут меняться между версиями системы, поэтому ориентируйтесь на актуальную инструкцию Apple, а не на старую пошаговую запись из стороннего обсуждения.

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

  • Console: найдите первую ошибку, относящуюся к моменту сбоя. Последующие сообщения могут быть следствием первоначальной ошибки, поэтому сравнивайте временной порядок, а не только последнюю строку.
  • Network: проверьте, завершились ли запросы моделей, текстур, шейдеров и файлов сцены. Ошибка запроса, неподходящий ответ сервера или неверный адрес ресурса указывают на путь загрузки, а не автоматически на нехватку памяти.
  • Состояние страницы: выясните, остаётся ли инспектор подключённым после пропажи изображения и продолжает ли страница отвечать на обычные действия. Это помогает отделить ошибку рендеринга от перезапуска вкладки.

При белом экране Three.js начинать с консоли или с Web Inspector? Для страницы на целевом устройстве нужен Web Inspector: он позволяет сопоставить Console и Network с происходящим в самой вкладке. Одна только консоль в настольном браузере не подтверждает, что та же ошибка возникает на visionOS; однако локально воспроизводимый сценарий в настольной версии может помочь быстрее найти проблему кода.

Если ресурсы не загружаются или Console показывает исключение до создания сцены, сначала устраните эту причину. Не меняйте формат всех текстур и не удаляйте половину геометрии наугад: иначе изменится сразу несколько условий, и результат теста станет неинформативным.

В журнале проекта отмечайте версию системы, версию браузера, сборку страницы, используемый режим запуска и последовательность действий. Эти записи помогают сравнивать повторные запуски и передавать разработчику не расплывчатое «в Safari иногда падает», а сценарий, который можно проверить.

При событии WebGL context lost исследуйте жизненный цикл

Если страница остаётся открытой, но трёхмерное изображение пропадает, добавьте наблюдение за событиями потери и восстановления WebGL-контекста:

const canvas = renderer.domElement;

canvas.addEventListener("webglcontextlost", (event) => {
  console.error("WebGL context lost", event);
});

canvas.addEventListener("webglcontextrestored", () => {
  console.info("WebGL context restored");
});

События не называют первопричину: они показывают изменение состояния контекста. Их следует сопоставить со временем загрузки ресурсов, переходом в XR-режим, сменой сцены и действиями пользователя. Не блокируйте обработку события и не пытайтесь продолжать использовать ресурсы старого контекста как будто он сохранился.

В проекте Three.js проверьте, не создаются ли при каждом обновлении новые текстуры, материалы и геометрия вместо повторного использования существующих объектов. Ищите ресурсы, создаваемые при смене состояния, но не освобождаемые при завершении этого состояния. Руководство Three.js по освобождению объектов и GPU-ресурсов разъясняет, почему удаление объекта из сцены и освобождение связанных ресурсов — не всегда одно и то же действие. Освобождать ресурс следует тогда, когда он действительно больше не используется; преждевременный dispose() способен породить новую ошибку.

У WebGLRenderer есть объект renderer.info, позволяющий наблюдать за частью состояния рендерера: например, за учтёнными геометриями, текстурами и вызовами отрисовки. Подробности приведены в документации Three.js по WebGLRenderer. Используйте эти значения для сравнения сцены до и после конкретного действия: если счётчик объектов растёт при повторном входе в сцену и не возвращается после выхода, проверьте повторное создание и освобождение ресурсов.

Важное ограничение: renderer.info не является показателем всей занятой памяти устройства и не раскрывает лимит памяти вкладки Safari. Снимок счётчика не доказывает OOM и не позволяет вывести точный размер свободной памяти. Для таких выводов нужна отдельная системная диагностика или воспроизводимый тест с данными реального устройства.

Означает ли WebGL context lost, что закончилась память? Нет. Событие фиксирует потерю контекста, но само по себе не указывает, вызвана ли она давлением памяти, состоянием графического процесса, сменой режима или другой причиной. Считайте OOM подтверждённым только при наличии соответствующего системного свидетельства или корректно задокументированного воспроизведения; в остальных случаях причина остаётся неустановленной.

Когда вкладка перезапускается, проверьте процесс отдельно от сцены

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

Сопоставьте результаты нескольких запусков. Если ошибка возникает каждый раз при загрузке одного и того же файла, сначала изучайте запрос и обработчик ресурса. Если сцена остаётся доступной, но рендеринг прекращается и регистрируется webglcontextlost, исследуйте жизненный цикл контекста. Если перезапускается вкладка, фиксируйте это отдельно и ищите доступные системные данные. Когда таких данных нет, запись в отчёте должна звучать как «вкладка перезапускается, причина не установлена», а не как «подтверждённый OOM Safari».

Не делайте вывод по одному скриншоту, сообщению из сообщества или единичному запуску. Сообщения разработчиков полезны как подсказка для выбора сценария проверки, но не заменяют логи конкретной версии приложения и целевого устройства.

Сведите сбой к минимальной сцене и повторите проверку

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

Для Three.js отдельно проверьте появление сцены без внешних текстур, затем с одной текстурой и без интерактивных эффектов. Для проекта Spline сравните исходную сцену с упрощённой копией, в которой временно отключены второстепенные элементы и анимация. Цель здесь — не провести полную оптимизацию, а найти условие, без которого сбой не возникает. Не меняйте одновременно экспорт, формат текстуры, модель и код запуска: тогда нельзя будет понять, какое изменение повлияло на результат.

Сравните одну и ту же сборку на настольном Safari, в симуляторе visionOS и на целевом физическом устройстве, если оно доступно. У симулятора другая среда выполнения, поэтому успешный запуск в нём помогает отсеять некоторые ошибки, но не подтверждает стабильность на реальном устройстве. Точно так же сбой только в симуляторе сам по себе не доказывает, что пользователь увидит его на физическом устройстве.

Доказывает ли симулятор, что WebXR-сцена будет стабильна на устройстве? Нет. Это отдельная точка проверки, а не замена тестированию на целевом оборудовании. В публикационном отчёте укажите, где именно выполнен запуск, какая версия сборки проверялась и какие шаги воспроизведения дали результат. Для команды, планирующей реальные тесты, полезно отдельно описать порядок проверки на целевом устройстве и в симуляторе, не выдавая одно за другое.

В результатах разделяйте наблюдения и интерпретации. «Событие потери контекста зарегистрировано после загрузки текстуры» — наблюдение. «Текстура вызвала OOM» — причинный вывод, для которого нужно дополнительное доказательство. Такая запись облегчает принятие решения и не заставляет команду переписывать сцену из-за неподтверждённого предположения.

Выберите следующий шаг по результату диагностики

Наблюдаемый результат Что проверить в первую очередь Решение по публикации
Запрос ресурса завершается ошибкой или Console фиксирует исключение до рендеринга Адрес, ответ и формат ресурса; место возникновения исключения Исправить код или загрузку, затем повторить тот же сценарий
Страница работает, но появляется webglcontextlost Создание, повторное использование и освобождение текстур, материалов и геометрии Исправлять жизненный цикл и сложность сцены только после воспроизводимого теста
Вкладка загружается заново, инспектор теряет соединение Повторяемость, запись загрузки, доступные системные журналы и состояние процесса Зафиксировать причину как неустановленную, пока нет подтверждающих данных
Сбой зависит от конкретной среды и не имеет подтверждённой причины Сравнение сборки на настольном Safari, в симуляторе и на физическом устройстве Ограничить показ или отложить публикацию, если риск для пользователя неприемлем

Перед решением о выпуске пройдите короткую проверку:

  • [ ] Ошибки Console и неудачные сетевые запросы записаны отдельно от ошибок рендеринга.
  • [ ] Потеря WebGL-контекста подтверждается событием, а не только исчезновением изображения.
  • [ ] Перезапуск вкладки не назван OOM без системной диагностики.
  • [ ] Сбой проверен на минимальной копии сцены с зафиксированной последовательностью действий.
  • [ ] Результаты симулятора не используются вместо проверки физического устройства.
  • [ ] Для неизвестной причины предусмотрен безопасный вариант показа или временное ограничение публикации.

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

Для локальной отладки и сборки Mac может быть полезнее компьютера, который постоянно занят другими задачами: проще закрепить окружение и повторять один и тот же сценарий. Но у такого подхода есть ограничения — он не воспроизводит физическое устройство visionOS, не подтверждает причину перезапуска вкладки и не заменяет доступ к целевому оборудованию. Если тестовой команде нужен временный Mac для настольной проверки и подготовки сборок, условия можно посмотреть в консоли KuzCloud и на странице KuzCloud. А решение о снижении сложности WebXR-сцены для публикации следует принимать по логам и повторяемым тестам на целевом устройстве, а не по неподтверждённой истории о Vision SE.

Проверяйте WebXR на удалённом Mac с KuzCloud

Арендуйте выделенный физический Mac mini M4 для проверки браузерных WebXR-сценариев в условиях, близких к реальному устройству.

Подключайтесь к рабочему столу через VNC или используйте SSH и полный root-доступ для настройки среды и инструментов диагностики.