Размещение 3D-объектов в AR: от raycast до стабилизации

Реализация AR-размещения 3D-объектов на плоскости

Мы в TrueTech регулярно решаем эту задачу для заказчиков из мебельного и ритейл-сектора. Поставить 3D-модель на обнаруженную плоскость стабильно — не один вечер работы. Объект должен стоять ровно при движении камеры, не «плыть» при смене освещения, адекватно масштабироваться и не утопать в поверхности. Мы предлагаем реализацию под ключ: от подбора формата модели до финальной интеграции в ваше приложение. В одном из проектов для мебельного ритейла мы столкнулись с проблемой «проваливания» объекта в плоскость при быстром движении камеры. Решением стало использование ARAnchor с динамическим смещением по нормали на 2 мм — это исключило Z-борьбу при любом освещении.

Форматы 3D-моделей и оптимизация для AR

Стандарт для мобильного AR — USDZ (iOS/RealityKit) и GLB/GLTF (ARCore/кросс-платформенно). Типичная ошибка: брать модель без оптимизации и пытаться грузить её в AR. Полигональность 500k треугольников, текстуры 4096×4096 без mip-mapping — гарантированный FPS провал на устройствах до A13.

Целевые параметры для мобильного AR:

Компрессия: KTX2 + Basis Universal для GLB, HEIC-текстуры в USDZ. В RealityKit — Reality Composer Pro (Xcode 15+) для запекания PBR-материалов прямо в .reality формат. Для Android используйте Android Studio с ARCore SDK 1.30+ для конвертации GLB.

Почему Raycast лучше hitTest для размещения?

С ARKit 4+ и ARCore 1.18+ предпочтительный метод определения точки размещения — Raycast. Он возвращает ARRaycastResult с target: .existingPlaneGeometry или .estimatedPlane. existingPlaneGeometry использует уже детектированную геометрию — точность в 2 раза выше, чем у устаревшего hitTest. Apple рекомендует raycast как основной метод (см. документацию ARKit). Более того, hitTest был объявлен устаревшим в iOS 14, и его использование может привести к отклонению приложения из-за требований App Store Review Guidelines (раздел 4.2: минимальная функциональность).

Пример на Swift:

let query = arView.makeRaycastQuery( from: arView.center, allowing: .existingPlaneGeometry, alignment: .horizontal ) let results = arView.session.raycast(query) if let first = results.first { placeEntity(at: first.worldTransform) } 

Для ARCore — Session.createRaycastQuery() + Frame.raycast() даёт более стабильный результат на краях плоскостей.

Как стабилизировать объект после размещения?

После первого размещения объект не должен «гулять» при движении камеры. Стандартный подход — привязка к AnchorEntity через ARAnchor:

let anchor = ARAnchor(transform: worldTransform) arView.session.add(anchor: anchor) let anchorEntity = AnchorEntity(anchor: anchor) anchorEntity.addChild(modelEntity) arView.scene.addAnchor(anchorEntity) 

Явный ARAnchor фиксирует позицию, и объект не обновляется вместе с уточнением плоскости. Без этого он смещается первые 10–15 секунд сессии, пока ARKit уточняет геометрию. Дополнительно можно применить фильтрацию Калмана к позиции якоря, если объект всё же дрожит.

Тени и физическое освещение

AR-объект без тени выглядит «летящим». В RealityKit тень создаётся установкой castsShadow = true у entity — contact shadow рендерится автоматически. В SceneKit для этого нужен directional light с castsShadow = true. Важно: при использовании environment texturing (ARKit, A12+) объекты получают отражения реального окружения. Металлические поверхности отражают интерьер — без этого хромированный предмет выглядит пластиковым. Включите environmentTexturing = .automatic в ARWorldTrackingConfiguration.

Какие жесты поддерживаются для манипуляции объектом?

После размещения пользователь должен иметь возможность перемещать, вращать и масштабировать объект. В RealityKit жесты добавляются в одну строку:

arView.installGestures([.translation, .rotation, .scale], for: entity) 

Для кастомного управления используйте UILongPressGestureRecognizer с непрерывным raycast — это даёт больший контроль над чувствительностью. При реализации вращения обязательно ограничьте ось Y: используйте simd_quatf(angle:axis:) только вокруг вертикальной оси, иначе объект «заваливается» при неточном жесте. На Android аналогично: GestureRecognizer из Sceneform или ArGestureRecognizer в ARCore.

Как тестировать AR-размещение на разных устройствах?

Критично протестировать на нескольких поколениях iPhone и Android-устройствах. Например, на iPhone XR (A12) raycast работает стабильно, но environment texturing потребляет дополнительную память — может проседать FPS при высокополигональных моделях. Рекомендуем использовать TestFlight для iOS и внутреннее тестирование Google Play для Android — это позволяет выявить проблемы с глубиной (Z-fighting) на разных версиях ARCore.

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

Наш опыт — более 20 успешных проектов в мобильной AR-разработке. Свяжитесь с нами для оценки вашего проекта — реализуем под ключ за 2–3 недели. Получите консультацию без обязательств.