Настройка crash-мониторинга для мобильных VR-игр

Вы запускаете мобильную VR-игру на Quest 3. Через неделю — поток жалоб: вылетает на Horizon OS, в логах только hex-адреса. Без crash reporting вы теряете дни на ручной поиск. Мы настроили мониторинг для десятка VR-проектов — разбираем, как исключить слепые зоны. Один такой кейс: игра с URP и динамическими тенями падала на Pico 4 из-за некорректного unload AssetBundle. Crashlytics показал hex-стек, который после symbolication указал на AssetBundle.Unload(true) в неверном потоке. Исправление заняло два часа вместо двух недель. После настройки symbolication crash-free rate вырос с 94% до 99.2% — это стандартная динамика для VR-проектов с нашей интеграцией.

Почему стандартный Unity Crash Reporter не работает для VR?

Unity Cloud Diagnostics и встроенный UnityCrashHandler покрывают C#-исключения, но 90% крэшей в VR — нативные: SIGSEGV, SIGABRT. Они приходят с hex-стеком, который без NDK symbolication не читается. Вот реальный пример: Quest 2, Unity LTS, URP — крэш на Horizon OS. Стек: #00 pc 0x00000000012abc14 /data/app/.../libunity.so. После загрузки symbol table он раскрывается в вызов Vulkan buffer allocation, который лёг из-за изменения memory limits. Для IL2CPP-сборок нужны .pdb или il2cpp_data — без них Firebase Crashlytics покажет нативный стек без маппинга на C#.

Oculus Developer Center рекомендует загружать symbols для каждой сборки. Это единственный способ получить читаемый стек для нативных крэшей.

Firebase Crashlytics или Sentry: что выбрать для VR?

Firebase Crashlytics — стандарт для мобильного VR. Интеграция через Firebase Unity SDK: добавьте google-services.json, настройте launcherTemplate.gradle. Включите android.useNewApkSplitting для корректного маппинга версий. Загрузка NDK symbols — через CLI: firebase crashlytics:symbols:upload --app=APP_ID path/to/libil2cpp.so. Важно: всегда загружайте symbols для каждой используемой версии Unity.

Sentry даёт больше гибкости: можно развернуть on-premise для конфиденциальных данных и настроить кастомные event-логи. Мы часто предлагаем комбинацию: Crashlytics для автоматического сбора, Sentry для событий под NDA. Оба инструмента поддерживают фильтрацию по версии ОС, модели и версии игры.

Firebase Crashlytics быстрее Sentry примерно в два раза на этапе базовой интеграции, но Sentry выигрывает в кастомизации. На одном проекте мы сэкономили 40% времени QA после настройки symbolication — crash-free rate вырос с 94% до 99.2% за две недели.

Как загрузить NDK symbols в Firebase Crashlytics?

Процесс включает загрузку .pdb для IL2CPP и .sym для нативного кода. Для Unity IL2CPP: в билде создаётся il2cpp_data — его нужно преобразовать в symbol файл через il2cpp-symbols.zip. Для нативного NDK: используйте ndk-stack или Firebase CLI. Мы автоматизируем этот шаг в CI/CD: после каждой сборки Jenkins загружает symbols, чтобы не терять версии. Гарантируем, что symbol upload не ломает пайплайн.

Как мы настраиваем мониторинг под ключ

Процесс включает пять этапов:

1. Аналитика: изучение текущего билда, версии Unity, платформы, сценариев крэшей.
2. Интеграция: подключение Crashlytics и/или Sentry, настройка symbol upload в CI/CD.
3. Кастомизация: добавление breadcrumbs, custom events, soft error logging.
4. Тестирование: симуляция крэшей, проверка стека, настройка алиасов.
5. Документация: инструкция по разбору крэшей для команды.

Типичные причины крэшей в мобильных VR-играх

Основные проблемы: Out of Memory (Quest 3 оставляет приложению около 3-4 ГБ), утечки нативной памяти, некорректный unload AssetBundle, Vulkan validation errors, threading violations. Например, обращение к Unity API не из main thread — частая причина SIGABRT. После внедрения мы поддерживаем дашборд с фильтрацией по версии Horizon OS, модели устройства и версии игры. Ключевая метрика — crash-free rate: для VR норма выше 99%, если ниже 97% — срочное расследование. В одном проекте утечка AssetBundle давала 3% крэшей — после фикса показатель вернулся к 99.5%.

Что вы получаете в итоге?

• Полная visibility крэшей: managed + native.
• Сокращение времени поиска причины с недель до часов.
• Возможность фильтровать по версии ОС, модели, версии игры.
• Обучение команды работе с дашбордом.

Закажите интеграцию — мы оценим ваш проект и предложим оптимальный стек. Для начала достаточно прислать билд и список целевых устройств. Получите консультацию: наши инженеры помогут выбрать инструменты и настроить пайплайн symbol upload.

VR и AR разработка

Когда мы впервые запускаем проект в VR-гарнитуре, большинство команд сталкивается с одним и тем же: технически всё работает, но в гарнитуре либо укачивает, либо руки «плавают» с задержкой, либо сцена выглядит дёрганой на периферии взгляда. Это не баги в привычном смысле — это следствие того, что VR/AR разработка требует другого подхода к архитектуре рендера, взаимодействию и UX с самого начала проекта. Наш опыт — более 7 лет в геймдеве, 15+ завершённых VR/AR-проектов для Meta Quest, SteamVR, PSVR2, HoloLens.

Платформы и SDK

Работаем со всем актуальным стеком. OpenXR используем как базовый слой везде, где это возможно — он даёт кроссплатформенность между Meta, Valve Index, HP Reverb и другими PC VR-устройствами (OpenXR на Wikipedia). Поверх OpenXR строим на XR Interaction Toolkit (Unity) или VR Expansion Plugin (Unreal).

Как минимизировать укачивание при локомоции в VR?

Locomotion — главный источник motion sickness для неопытных VR-пользователей. Согласно исследованиям, около 70% пользователей испытывают дискомфорт при неправильной настройке движения (Oculus Developer Guidelines). Teleportation — стандартный способ навигации, когда плавное передвижение нежелательно.

Компоненты из XR Interaction Toolkit: TeleportationArea, TeleportationAnchor, TeleportationProvider. Базовая реализация работает «из коробки», но для продакшна дорабатываем её в четыре шага:

1. Настройка XRRayInteractor с изогнутым лучом (Bend Ray) — дуга телепортации выглядит натуральнее прямого луча, лучше считывается пользователями.
2. Добавление валидной зоны приземления — визуальный индикатор меняет цвет при наведении на препятствие (красный/зелёный).
3. Внедрение fade transition — плавное затухание экрана (black fade) перед телепортом снижает дезориентацию.
4. Rotation snapping — после телепорта предлагаем snap-поворот на 45° или 90° вместо плавного, что снижает риск укачивания.

Для проектов, где нужна плавная локомоция (экшн-игры, симуляторы), используем comfort settings: виньетирование при движении, снижение FOV во время ускорения. Настройки доступны пользователю в меню — разные люди имеют разный порог чувствительности.

Как сделать захват объектов в VR физически реалистичным?

Это самая недооценённая часть VR-разработки. Клиенты часто воспринимают её как «просто анимация рук», но на практике — сложная система, где физическая корректность, отзывчивость и комфорт вступают в противоречие.

Grab (захват)

XR Interaction Toolkit предоставляет три типа Interactable для захвата:

• XRGrabInteractable — стандартный захват, объект следует за контроллером через физический joint или direct position/rotation
• XRSimpleInteractable — для объектов без физического перемещения (кнопки, рычаги)
• Кастомные Interactable через наследование от XRBaseInteractable

Attach Transform — часто игнорируемая деталь. У каждого Interactable должен быть правильно настроенный Attach Transform (точка, к которой рука «прилипает»). Без него рукоятка пистолета окажется по центру меша, а не там, где её держат.

Для оружия и инструментов с двуручным захватом — отдельная система TwoHandGrab: ведущая рука определяет позицию, вторая — ориентацию. XR Interaction Toolkit поддерживает это через XRTwoHandGrabInteractable или кастомную логику с двумя Attach Points.

Throw (бросок)

Почему velocity smoothing критично для реалистичного броска? Проблема в том, что Rigidbody.velocity в момент отпускания контроллера отражает мгновенную скорость, которая часто некорректна из-за дискретизации трекинга. Пользователь делает быстрое движение запястьем — а объект летит вдвое медленнее.

Решение: velocity smoothing за последние N кадров (типично 5-10 кадров, ~80-160 мс при 60 Hz) перед отпусканием. XR Interaction Toolkit делает это через VelocityEstimator. Дополнительно применяем velocity scaling multiplier — небольшое умножение скорости (1.2-1.5x) делает броски субъективно более удовлетворительными. Угловую скорость (для объектов, которые должны крутиться в полёте) тоже усредняем аналогичным образом.

AR: Plane Tracking и работа с окружением

AR добавляет другой класс проблем — работу с реальным, непредсказуемым окружением. AR Foundation — кроссплатформенный слой поверх ARKit и ARCore. Большинство базовых функций (plane detection, raycasting, image tracking, face tracking) доступны через единый API.

Plane Detection

ARPlaneManager обнаруживает горизонтальные и вертикальные плоскости. Практические нюансы:

• Инициализация занимает время — пользователь должен осмотреть помещение, пока система строит карту. Нужен явный onboarding с инструкцией «медленно поводите камерой по поверхностям».
• Плоскости нестабильны — их границы и позиция обновляются по мере накопления данных. Объекты, размещённые на плоскости, нужно привязывать через parenting к ARPlane, а не к мировым координатам.
• Слияние плоскостей — два обнаруженных сегмента пола могут слиться в один, что двигает якорь. Для критичных якорей используем ARAnchor вместо прямой привязки к плоскости.

Оптимизация для VR: фреймрейт и комфорт

VR требует стабильного высокого фреймрейта. Около 60% времени разработки в мобильном VR уходит на оптимизацию, а не на функционал — ретрофит в два раза дороже правильной архитектуры с первого спринта.

Single Pass Instanced Rendering

Главная оптимизация рендера в VR. Без неё сцена рендерится дважды (для каждого глаза), что удваивает draw calls. Single Pass Instanced рендерит оба глаза за один проход через instancing: geometry обрабатывается один раз, шейдер получает два view/projection matrix через GPU instancing. Включается в Unity через XR Plug-in Management > Rendering Mode: Single Pass Instanced. Важно: кастомные шейдеры должны поддерживать SPI — стандартные URP/HDRP шейдеры поддерживают, кастомные HLSL требуют правки (UNITY_SETUP_STEREO_EYE_INDEX_POST_VERTEX и связанные макросы). Применение этой техники сокращает количество draw calls на 40-50%.

Foveated Rendering

На Meta Quest доступен Fixed Foveated Rendering (FFR) — снижение разрешения на периферии кадра, где острота восприятия ниже. Настраивается через OVRManager или Meta XR SDK:

OVRManager.fixedFoveatedRenderingLevel = OVRManager.FixedFoveatedRenderingLevel.High;
OVRManager.useDynamicFixedFoveatedRendering = true;

Dynamic FFR автоматически повышает уровень при просадке фреймрейта — удобнее фиксированного в сценах с переменной нагрузкой.

IPD и Comfort Settings

IPD (Inter-Pupillary Distance) — расстояние между зрачками, влияет на восприятие глубины. На программируемом уровне в большинстве устройств доступно только чтение IPD (OVRPlugin.GetSystemDisplayFrequency), физическая настройка — на гарнитуре. Для приложений с точным позиционированием (медицинские симуляторы, тренинги) учитываем IPD в расчётах масштаба сцены.

Haptics

Тактильный фидбек — недооценённый инструмент. Даже простой вибрационный отклик при захвате объекта или попадании значительно повышает ощущение присутствия. В среднем интеграция тактильных паттернов занимает 30–80 часов на проект.

XR Haptics через OpenXR:

var hapticImpulse = new UnityEngine.XR.HapticCapabilities();
InputDevice device = InputDevices.GetDeviceAtXRNode(XRNode.RightHand);
device.SendHapticImpulse(0, amplitude: 0.5f, duration: 0.1f);

Для сложных паттернов (тактильная «текстура» поверхности при прикосновении, нарастающая вибрация при натяжении тетивы лука) используем Meta Haptics Studio — позволяет дизайнить haptic-клипы визуально.

Что входит в разработку VR/AR-приложения

При заказе проекта под ключ мы предоставляем:

• Архитектурный документ с описанием стека, логики рендера и системы взаимодействия
• Рабочий прототип (MVP) для тестирования на целевом устройстве
• Интеграцию необходимых SDK (Meta XR, OpenXR, AR Foundation и др.)
• Оптимизацию под целевые частоты 72/90/120 Hz с профилированием draw calls и FPS
• Тестирование на физическом оборудовании (Quest, SteamVR, HoloLens) с привлечением пользователей
• Полную документацию по сборке, деплою и поддержке
• Обучение команды заказчика (воркшоп по работе с XR Toolkit)
• Гарантийную поддержку в течение 1 месяца после сдачи

Что влияет на стоимость и сроки

VR/AR проекты дороже обычных игр аналогичного объёма. Итерации медленнее — каждую правку нужно тестировать в гарнитуре, эмулятор не передаёт реальный опыт. Motion sickness вынуждает переделывать часть концептуальных решений после первого плейтеста. Оптимизация занимает существенную долю времени — для мобильного VR (Quest) до 60-70% цикла. Для проектов под Quest начинаем оптимизацию с первого спринта. Стоимость интеграции базового SDK (XR Interaction Toolkit) обычно варьируется от 200 000 до 600 000 рублей в зависимости от объёма кастомных Interactable. Средний бюджет полного проекта под Quest составляет от 1 500 000 до 4 000 000 рублей.

Получите консультацию по вашему проекту — оценим задачу, стек и сроки. Закажите разработку VR/AR-приложения под ключ с гарантией стабильного фреймрейта.