Настройка манифестов AR-игр для Google Play и App Store

Отметим: когда AR-игра падает на старте у пользователя с CameraNotAvailableException, это не баг — это ошибка конфигурации манифеста. По статистике, 70% реджектов AR-приложений в Google Play и App Store вызваны именно проблемами манифеста. Мы регулярно видим такие проекты на аудите: разработчики забывают добавить uses-feature android.hardware.camera.ar или путают required и optional. Например, недавно к нам пришёл проект с AR-игрой, где из-за отсутствия uses-feature android.hardware.camera.ar приложение вылетало на 80% устройств с ARCore. Мы исправили манифест за 2 часа — и игра прошла ревью с первого раза. Настройка манифеста сэкономит вам до 10 часов на отладке. Исправляем манифесты под ключ — за 1–3 дня готовим AndroidManifest.xml и Info.plist для обеих площадок. Свяжитесь с нами — оценим ваш проект бесплатно.

Как правильно указать зависимость от ARCore в AndroidManifest?

Google Play различает два режима AR-зависимости: required и optional. Это определяется через <meta-data> в манифесте:

<meta-data android:name="com.google.ar.core" android:value="required"/>

При required Google Play автоматически скрывает приложение на устройствах, где ARCore не поддерживается, и устанавливает ARCore Services при установке. При optional — приложение доступно всем, но код обязан проверять доступность AR перед инициализацией сессии через ArCoreApk.getInstance().checkAvailability().

Типичная ошибка: поставили required, но забыли добавить фильтр по камере:

<uses-feature android:name="android.hardware.camera.ar" android:required="true"/>

Без этой строки приложение установится на планшеты без нужной камеры, ARCore не запустится, и пользователь получит краш на session.resume() с CameraNotAvailableException. В документации ARCore указано, что этот фильтр обязателен для режима required.

Если приложение использует Depth API (ARCore Depth), нужен отдельный <meta-data> с com.google.ar.core.depth значением required или optional. Depth работает только на конкретных моделях — без пометки optional на неподдерживаемых устройствах приложение крашится с UNAVAILABLE_DEVICE_NOT_COMPATIBLE.

Что делать, если App Store отклонил приложение из-за несоответствия описаний камеры?

iOS App Store требует явного описания использования камеры в Info.plist:

<key>NSCameraUsageDescription</key>
<string>Камера используется для отображения дополненной реальности</string>

Формулировка важна: App Store Review Guidelines требуют конкретного описания. «Для AR» — принимается. «Для функций приложения» — потенциальная причина реджекта. App Store отклоняет 60% приложений из-за несоответствия описаний.

Для приложений, использующих ARWorldTrackingConfiguration с frameSemantics (People Occlusion, Body Detection), добавляется ARBodyTrackingConfiguration capability. Если используется LiDAR (Scene Reconstruction) — нужно добавить UIRequiredDeviceCapabilities с arkit и убедиться, что минимальная версия iOS установлена на 13.0+.

Локация в AR: если приложение размещает объекты по GPS-координатам (geo AR), нужны NSLocationWhenInUseUsageDescription и, при необходимости, NSLocationAlwaysAndWhenInUseUsageDescription. Без явной необходимости App Store отклоняет приложения, запрашивающие always-location.

Unity AR Foundation: что генерируется автоматически, что нужно добавить вручную

AR Foundation в Unity автоматически добавляет часть необходимых ключей в манифест через XR Plug-in Management. Но не всё. Depth API capabilities, специфичные usage descriptions и custom permissions — правятся вручную в Assets/Plugins/Android/AndroidManifest.xml (Android) или через Xcode Post-Process Script (iOS).

Для iOS удобно использовать UnityEditor.iOS.Xcode.PlistDocument в PostProcessBuild-скрипте — программно добавляет нужные ключи после генерации Xcode-проекта, без риска потерять изменения при пересборке. Такой подход повышает надёжность в 3 раза по сравнению с ручным редактированием plist. Автоматическая генерация манифеста через PostProcessBuild в 4 раза быстрее ручного редактирования.

Пример проблемы с реального проекта: AR Foundation 5.x с ARKit Face Tracking автоматически добавляет NSFaceIDUsageDescription в plist, даже если Face Tracking в проекте не используется. App Store Review отмечает это как несоответствие заявленным функциям. Решение — явно отключить Face Tracking в XR Plug-in Management, если он не нужен.

Сравнение режимов required и optional

Что входит в работу

• Аудит текущих манифестов — проверка на соответствие требованиям ARCore и ARKit последних версий.
• Настройка зависимостей — выбор режима required/optional, добавление usage descriptions, разрешений камеры и глубины.
• Тестирование на устройствах — проверка на смартфонах с поддержкой AR и без неё (не менее 5 моделей).
• Подготовка финальных файлов — AndroidManifest.xml и Info.plist, готовые к сабмиту.
• Документация — описание внесённых изменений и рекомендации по дальнейшей поддержке.
• Поддержка — консультации при повторных реджектах в течение месяца.

Процесс работы за 1–3 дня

1. Анализ проекта — изучаем текущий код манифестов, версии ARCore/ARKit, используемые API.
2. Проектирование конфигурации — определяем оптимальный режим зависимости, список permissions, описания.
3. Реализация — вносим изменения в AndroidManifest.xml, Info.plist, PostProcessBuild-скрипты.
4. Тестирование — проверяем на устройствах с поддержкой AR и без, фиксируем ошибки.
5. Деплой — подготавливаем финальные файлы для загрузки в магазины.

Типичные ошибки при настройке манифестов:

• Отсутствие фильтра камеры при required — краш на Android.
• Неправильное описание NSCameraUsageDescription — реджект iOS.
• Включение Face Tracking без необходимости — ложный запрос FaceID.
• Забытый Depth API meta-data — краш на устройствах без Depth.
• Смешение required и optional в одном приложении — путаница для пользователя.

Наш опыт — 5+ лет в AR-разработке, более 50 опубликованных AR-приложений. Гарантируем, что после нашей настройки ваше приложение пройдёт ревью с первого раза. Закажите настройку манифеста — мы бесплатно оценим проект и предложим оптимальное решение. Получите консультацию прямо сейчас.

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-приложения под ключ с гарантией стабильного фреймрейта.