Документация: Импорт 3D‑тура в VPano

Часть 2 — загрузка модели/панорам, назначение слотов и настройка тегов/меню/дизайна в 3D Studio.

Что будет в результате

После этих шагов у вас будет готовый 3D‑тур: загруженная low‑poly модель, назначенные панорамы, сохранённая стартовая позиция, теги и меню/дизайн. Проект можно публиковать и экспортировать.

Шаг 0 — Создать 3D‑проект

  1. Откройте профиль проекта: Dashboard → Проекты → выберите профиль.
  2. В блоке «3D проект» нажмите «Создать 3D проект» (если ещё не создан).
  3. Перейдите в «3D проект» (wizard).

Шаг 1 — Загрузить модель (FBX/GLB/GLTF)

Страница wizard: /dashboard/profiles/<profileId>/projects-3d. После загрузки система ищет маркеры по именам pano_1..N или panorama_1..Nи создаёт «слоты панорам».

Wizard: загрузка модели FBX/GLB/GLTF
Если маркеры не найдены
Проверьте: маркеры реально экспортированы в FBX/GLB и названы строго по шаблону.

Шаг 2 — Загрузить панорамы (изображения)

  1. Загрузите все панорамы одним пакетом (JPG/PNG/WebP).
  2. Система автоматически сопоставит файлы по имени (например, pano_1.jpg → слот pano_1).
  3. Если какие-то файлы не сопоставились — они попадут в список «Неназначенные файлы».
Wizard: загрузка панорам
Полезно
Если ошиблись при ручном назначении — используйте кнопку «Отменить» (Undo последнего назначения).

Шаг 3 — Проверить слоты панорам

  • Откройте блок «Слоты панорам» и проверьте превью каждого слота.
  • Если слот заполнен неправильно — нажмите «Убрать» и назначьте нужный файл заново.
Wizard: неназначенные файлы и ручное назначение

Шаг 4 — Финализировать проект

Нажмите «Финализировать проект». Если не все слоты заполнены, система покажет ошибку.

3D Studio — теги, меню, дизайн, названия сцен

После загрузки панорам откройте Studio (кнопка «3D Studio» ). В Studio справа есть live‑preview , слева — вкладки настройки.

Теги

  • Создайте тег → нажмите «Разместить / переместить» и поставьте тег в viewer.
  • Настройте заголовок/описание, цвет, отображение (текст/иконка), размер и высоту.
  • Можно загрузить изображения для тега (сервер оптимизирует в WebP).
Studio: вкладка Теги

Панорамы (заголовки сцен)

  • На вкладке «Панорамы» задайте человеко‑читаемые названия сцен.
  • Эти названия записываются и показываются в ленте сцен.
Studio: вкладка Теги

Меню

  • Создавайте группы и пункты меню: внутренние (узел сцены) и внешние (URL).
  • Меняйте порядок пунктов перетаскиванием (Drag).
Studio: вкладка Меню

Дизайн

  • Брендинг/логотип/цвета, UI и навигация.
  • При необходимости нажмите «Обновить» в предпросмотре справа.
Studio: вкладка Дизайн
Стартовая позиция
В Studio нажмите «Сохранить старт» — сохранится текущая поза.

Настройки проекта

В профиле проекта есть модальное окно «Настройки проекта» (иконка справа сверху). Там можно редактировать информацию о проекте, настройки Viewer UI и выполнить удаление.

Основное
  • Название, слаг, описание.
  • Публичный доступ (публикация проекта).
  • Ограничение качества для экспорта: Skybox / Walk.
  • Экспорт ZIP (архив для хостинга) — если доступно по тарифу.
Viewer UI
  • Показывать список сцен в экспорте.
  • Логотип проекта (загрузка/удаление).
Опасная зона
  • Удаление проекта вместе со всеми панорамами и файлами.
  • Для подтверждения нужно ввести слаг проекта.
Совет
Если проект «заблокирован» (лимит тарифа), часть действий (публичный доступ/экспорт) может быть недоступна.

Частые ошибки

  • Нет маркеров в модели → слоты не создаются.
  • Имена панорам не совпадают с pano_1..N → авто‑назначение не сработает.
  • Не все слоты заполнены → «Финализировать проект» выдаст ошибку.
  • Viewer ещё не готов → кнопка «Сохранить старт» недоступна.