Объекты сцены
Как добавить 3D-модель в AR-сцену
3D-модель — самый частый тип объекта в AR-проекте: товар, персонаж, декоративный элемент, архитектурная деталь. В этой статье разберём, какой файл нужен, как он появляется на сцене, как выставить правильный размер и почему модель иногда нужно поставить именно на «пол», а не просто на нужную высоту вручную.
Какой файл понадобится
Letary принимает модели в формате GLB или GLTF — это стандартные форматы для 3D в вебе и AR, их экспортирует большинство 3D-редакторов (Blender, Cinema 4D, 3ds Max) и многие маркетплейсы 3D-моделей уже предлагают готовый GLB-экспорт. Формат GLB удобен тем, что упаковывает геометрию, текстуры и анимации в один файл — ничего собирать из нескольких частей не нужно, достаточно загрузить один .glb.
Как добавить модель на сцену
В левой панели редактора сцены нажмите Добавить и выберите 3D модель (GLB).
Откроется системный проводник — выберите файл на компьютере. Letary загрузит модель и сразу разместит её в центре сцены поверх маркера; объект появится в списке слева под именем файла (его можно переименовать двойным кликом — например, чтобы не путаться, если моделей в сцене несколько).
Настройка размера и положения
Выделите модель — справа откроется панель настроек. Верхний блок (Position, Rotation, Scale) общий для всех типов объектов и описан в статье про обзор редактора; для 3D-моделей отдельно стоит обратить внимание на блок «Размер» внизу панели:
- Высота — задаёт равномерный масштаб модели через понятную величину: сколько места модель займёт по вертикали, а не абстрактный коэффициент масштаба. Значение указывается в единицах сцены: для формата «AR в пространстве» это метры, а для маркеров (QR, изображение) — доли ширины самого маркера, то есть высота 1 означает «равна ширине QR-кода или картинки-маркера».
- Поставить на пол — кнопка, которая одним нажатием опускает модель так, чтобы её нижняя точка легла ровно на плоскость сцены (пол или маркер), вместо подбора нужного значения Position по оси Y вручную. Особенно полезно после того, как вы поменяли высоту модели — без этой кнопки модель может «зависнуть» в воздухе или наполовину уйти под маркер, если её опорная точка не совпадает с нижним краем.
Что ещё есть в панели настроек
Помимо размера и положения, панель модели содержит два блока, которые пригодятся по мере усложнения сцены:
- Настройки анимации — если в GLB-файле есть анимация (или несколько), здесь можно включить автозапуск, выбрать нужную анимацию по имени, задать режим воспроизведения (зациклить, один раз или заданное число раз) и решить, скрывать ли модель после её окончания. Подробный разбор — в статье про анимации 3D-моделей.
- Настройки рендера → Карта окружения — набор готовых окружений (студия, ночной город, тёплый закат и другие), которые модель как бы отражает на своих глянцевых и металлических поверхностях. Без карты окружения металлы и стекло на модели могут выглядеть тускло и плоско; включение подходящей карты — самый быстрый способ сделать материалы живыми без ручной настройки света. Подробнее про свет и материалы — в статье про свет и свечение.
Частые вопросы
Модель загрузилась, но её не видно на сцене — в чём дело? Чаще всего дело в масштабе: у экспортированных из некоторых 3D-редакторов моделей единицы измерения могут не совпадать с ожидаемыми, и модель оказывается либо огромной (камера внутри неё), либо микроскопической. Откройте панель настроек и попробуйте задать высоту явно через поле «Высота» в блоке «Размер» — это сразу приведёт модель к вменяемому масштабу независимо от того, что было в исходном файле.
Можно ли загрузить несколько 3D-моделей в одну сцену? Да, ограничений на количество объектов одного типа нет — каждая модель добавляется отдельной кнопкой «Добавить» → «3D модель (GLB)» и становится своей строкой в списке слева.
Модель не поддерживает текстуры/материалы из моего 3D-редактора — почему? Убедитесь, что при экспорте в GLB были включены текстуры и материалы (в большинстве редакторов это отдельная галочка при экспорте) — формат GLB поддерживает материалы PBR (физически корректный рендеринг) практически без ограничений, но именно на этапе экспорта их проще всего случайно исключить.
Чем «Поставить на пол» отличается от того, чтобы просто выставить Position → Y в 0? Ноль по оси Y — это положение опорной точки (origin) модели, а не её нижнего края: у многих моделей opорная точка находится в центре, и Position Y = 0 оставит половину модели «под полом». «Поставить на пол» учитывает реальные габариты модели и всегда прижимает именно нижнюю точку к поверхности, независимо от того, где в файле расположен origin.