Теги и сцены в 3D Студии

После импорта модели вы попадаете в 3D Студию. Эта страница описывает две вкладки из группы «Контент»:

• Сцены — список панорам тура: переименование, видимость, ИИ-названия и расчёт высоты пола для walk-режима.
• Теги — кликабельные маркеры в 3D-пространстве: открывают карточку, ведут на внешнюю ссылку, переключают сцену или запускают автоматический тур.

Верхняя панель Студии сгруппирована: Контент (Сцены · Теги · Медиа) → Навигация (Меню · Кнопки) → Вид (Дизайн · Визитка) → Тур. Все изменения сохраняются автоматически.

Откройте вкладку «Теги». Слева — список тегов проекта, справа — настройки выбранного тега.

Создание

• В заголовке списка нажмите «Новый» (с иконкой +). Если тегов ещё нет, в центре пустого списка появится CTA «Создать первый тег».
• Сразу после создания включается режим размещения: кнопка в шапке начинает пульсировать янтарным цветом и подсказывает «Кликните по модели, чтобы разместить тег». Рядом — кнопка «Отмена».
• Кликните в нужную точку модели в превью. Тег зафиксируется на этой поверхности, и нормаль поверхности автоматически подхватится для ориентации.
• Если закрыть режим без клика, тег останется в списке с пометкой «не размещён» — над панелью свойств появится янтарная пунктирная подсказка «Тег ещё не размещён…». Включите размещение снова кнопкой в шапке.

Три типа

В блоке «Тип» выбирается одна из трёх карточек:

• Текст — слово или короткая фраза на цветной плашке. По умолчанию синий фон, белый текст, размер 16 px.
• Иконка — пиктограмма (Material Symbols) на круглом фоне или без него.
• Полигон — полупрозрачная область, выделяющая часть поверхности (например, диван или окно). Для полигонов блок «Положение» не используется.

Дублирование и удаление

• В шапке карточки свойств — кнопка «Дублировать» (иконка копирования). Создаётся точная копия рядом с оригиналом.
• Кнопка «Удалить» (корзина) показывает диалог-подтверждение: «Удалить тег? Тег «…» будет удалён вместе с изображениями, описанием и позицией. Действие необратимо.»
• В списке тегов работают клавиши Backspace и Delete — удаляют выбранный тег.

Блок «Действие при клике» определяет, что произойдёт, когда посетитель кликнет по тегу. Доступно пять вариантов в виде карточек:

• Открыть карточку (panel) — стандартная всплывающая карточка с заголовком, описанием и галереей изображений.
• Внешняя ссылка (external) — переход по URL. Поле ссылки + чекбокс «Открывать в новой вкладке».
• Переход к сцене (internal) — выпадающий список сцен проекта. При клике посетитель попадает на выбранную сцену.
• Запустить экскурсию (tour) — запускает автоматический обход (см. Автоматический тур). Если тур ещё не настроен, рядом появится янтарное предупреждение.
• Без действия (none) — тег только декоративный, клик ничего не делает (полезно для подписей-указателей).

Для panel заполняется обычный заголовок и описание. Для других действий поле текста подписано как «Заголовок (подсказка)» с пояснением «Показывается как подсказка при наведении».

Блок «Вид» отвечает за внешний вид маркера. Состав полей зависит от выбранного типа.

Фон тега

Две карточки-переключателя:

• С фоном — текст или иконка размещаются на цветной плашке (круг для иконки, скруглённая плашка для текста).
• Без фона — только текст или иконка, плашка отсутствует. Полезно для подписей прямо на стене или потолке.

Цвета

Цвет-пикеры показываются в зависимости от типа и наличия фона:

• Полигон → один цвет — «Цвет полигона».
• Иконка с фоном → два цвета — «Цвет фона» и «Цвет значка».
• Иконка без фона → только «Цвет значка».
• Текст → цвет фона (если включён) и цвет текста.

У каждого пикера есть превью-плашка и поле ввода HEX-значения для точной настройки под бренд.

Иконка

Для типа «Иконка» рядом появляется пикер из библиотеки Material Symbolsс поиском по названию.

Размер

Ползунок «Размер» для текстовых и иконочных тегов: от 8 до 256 px, с числовым полем справа и подсказкой px. Для полигона размер задаётся точками самой формы.

Блок «Положение» определяет, как тег ведёт себя в 3D-пространстве. Для типа Полигон этот блок не отображается.

Режим

• К камере (билборд) — тег всегда повёрнут лицом к посетителю, как обычный маркер.
• На поверхности — тег приклеен к поверхности (стене, полу, потолку) и поворачивается вместе с ней. Доступно, только если при размещении получилось зафиксировать нормаль поверхности.

При выборе «К камере»

• Высота — сдвиг по вертикали от точки клика, от 0 до 3 м. Удобно, чтобы поднять подпись над предметом.
• Наклон — поворот плашки от 0 до 360°.

При выборе «На поверхности»

• Отступ от поверхности — приподнимает тег над поверхностью, чтобы он не «провалился» в неё (0–3 м).
• Поворот — поворот тега в плоскости поверхности, 0–360°.

Чтобы теги не загромождали обзор на больших объектах, можно ограничить расстояние, с которого они видны.

• Ползунок — от 1 до 30 м, по умолчанию 8 м.
• Чекбокс «Без ограничения» — теги видны независимо от расстояния (внутри сохраняется значение 0, что означает «бесконечность»).

Под ползунком — пояснение: «Теги исчезают, когда камера дальше указанного расстояния».

Большую часть работы с тегами можно делать прямо в 3D-превью — без боковой панели свойств.

Синхронизация выбора

Клик по тегу в превью выделяет его в списке слева (с автоскроллом) и автоматически переключает Студию на вкладку «Теги», если она не активна. Клик в списке — наоборот, подсвечивает тег в 3D.

Перетаскивание в 3D

Текстовые и иконочные теги можно перетащить мышью прямо во вьюере: при отпускании координаты и нормаль поверхности обновляются автоматически.

HandlesOverlay

Вокруг выбранного тега появляется пунктирное кольцо с четырьмя ручками:

• Центральная — перемещение (Move).
• Сверху справа — поворот (Rotation).
• Снизу слева — масштаб (Resize).
• Сверху по центру — высота (для режима «К камере»).

Плавающая карточка

Под тегом выводится компактная карточка с inline-редактированием: заголовок, «таблетка» текущего действия, переключатель фона, два цвет-пикера и крестик закрытия. Клики по элементам карточки и Handles не запускают инерцию панорамы — можно работать спокойно, не уводя камеру.

Если выбрано действие «Открыть карточку», появляется блок управления изображениями для галереи внутри карточки.

• Dropzone — перетащите файлы PNG / JPG / WebP или выберите вручную. Сервер автоматически конвертирует их в WebP, ужимая до 1600 × 1080 px.
• Кнопка «Из медиатеки» — открывает Медиатеку с уже загруженными файлами проекта (включая повторное использование между сценами).
• Загруженные изображения отображаются плиткой 2–3 столбца с превью. При наведении на плитку появляется кнопка-корзина для удаления.

Все действия с тегами поддерживают историю: создание, удаление, перемещение (включая drag в 3D), правки свойств и групповые операции. Глубина истории — 20 шагов.

• В заголовке списка тегов — кнопки «Отменить» (иконка Undo) и «Повторить» (иконка Redo).
• Tooltip напоминает горячие клавиши: «Отменить (Ctrl + Z)» и «Повторить (Ctrl + Shift + Z)». Дополнительно работает Ctrl + Y.
• Сочетания работают только на вкладке «Теги» и игнорируются, пока фокус в поле ввода (input / textarea), чтобы не мешать редактированию текста.
• История подхватывает даже действия, выполненные внутри 3D-превью — фокус внутри iframe вьюера не отключает горячие клавиши.

Стартовая позиция — это поза камеры (yaw / pitch + активная сцена), с которой тур открывается в публичном просмотрщике.

• Кнопка «Сохранить старт» (с иконкой Save) находится в шапке вьюера в правом верхнем углу превью, а не на вкладке «Сцены».
• Пока вьюер не готов, кнопка неактивна и показывает tooltip «Viewer ещё не готов». После готовности — «Сохранить стартовую позицию».
• Во время сохранения подпись меняется на «Сохранение…».
• Поза берётся непосредственно из текущего состояния вьюера — поверните камеру в нужное положение, выберите сцену и нажмите кнопку.

Вкладка называется «Сцены» (а не «Панорамы»). Карточка озаглавлена «Сцены и настройки».

Шапка вкладки

• Чекбокс «Авто» — включает / выключает автосохранение списка сцен (по умолчанию включён).
• Кнопка «Обновить» — заново загружает данные с сервера.
• Кнопка «ИИ-названия» — массовая генерация заголовков (см. раздел ниже). Появляется, если на тарифе включён ИИ-помощник.
• Поле поиска — фильтрует список по имени маркера или заголовку.

Расчёт высоты пола

В верхней части вкладки есть кнопка «⬇ Рассчитать высоту пола для маркеров». Она вычисляет высоту пола под каждым маркером панорамы — это нужно для корректного walk-режима. Подробно описано в Режиме прогулки.

Карточка сцены

Каждая строка списка содержит:

• Превью — миниатюра панорамы (lazy-loading).
• Имя из 3D-модели — pano_1, pano_2, моноширинным шрифтом.
• Бейдж «Скрыто» (красный), если сцена выключена в обоих списках.
• Поле «Заголовок» с подсказкой «Например: Холл / Кухня / Спальня…».
• Краткое описание сцены (одна строка), если оно задано.
• Два переключателя справа:
  • 🎯 Хотспот — показывать ли маркер этой сцены прямо на 3D-модели (точка перехода в пространстве).
  • 📋 Лента — показывать ли сцену в нижней ленте и в меню навигации.

Карточки можно сворачивать / разворачивать аккордеоном. Если выключены оба переключателя, карточка становится бледной (opacity 60%), и в заголовке аккордеона показывается счётчик скрыто N.

Массовое управление

Под шапкой — панель с подсказкой о количестве отфильтрованных сцен и кнопками «Включить все» / «Выключить все» для переключателя «В списке сцен» (Лента).

Кнопка «ИИ-названия» в шапке вкладки «Сцены» открывает диалог массовой генерации заголовков. Доступна на тарифах с подключённым ИИ.

• Запрос отправляется к эндпоинту /api/ai/suggest-scene-titles и стримит результаты через SSE: предложения появляются по мере готовности каждой сцены, без ожидания ответа целиком.
• Рядом с каждой сценой во время стрима крутится спиннер. После получения предложения — чекбокс «Принять» и inline-поле для правки текста.
• Кнопка «Применить выбранные» внизу диалога одним действием записывает все отмеченные предложения в заголовки сцен.

Обе вкладки сохраняют изменения автоматически — публиковать тур заново не нужно.

• Теги: внизу панели свойств — «липкая» полоса со статусом («Сохранено» / «Сохранение…»). Debounce около 600 мс — сохранение начинается вскоре после последнего изменения.
• Сцены: по умолчанию автосохранение включено. Если выключить чекбокс «Авто» в шапке, появится явная кнопка «Сохранить».
• Сочетание Ctrl + S (или Cmd + S на macOS) принудительно сбрасывает все активные изменения на сервер.

Связанные страницы:

• Дизайн 3D-тура — палитры, миникарта, цветокоррекция, солнце, тулбар.
• Медиатека — единое хранилище изображений и видео проекта.
• Медиа-экраны — видео и картинки прямо на поверхностях модели.
• Автоматический тур — настройка действия «Запустить экскурсию» для тегов.
• Режим прогулки — расчёт высоты пола для маркеров сцен.
• Настройки и экспорт 3D-тура — приватность, ZIP-экспорт, white-label.