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

Модальное окно «Настройки проекта» живёт не в 3D Студии, а на странице профиля проекта: /dashboard/profiles/[profileId].

1. Откройте страницу профиля проекта в дашборде.
2. Нажмите иконку ⚙ в шапке профиля — откроется выпадающее меню (DropdownMenu).
3. Выберите пункт «Настройки» — появится модальное окно с заголовком «Настройки проекта» и описанием «Редактируйте информацию, Viewer UI и удаление проекта».

В этом же выпадающем меню есть destructive‑пункт «Удалить проект» — он открывает отдельный диалог подтверждения, параллельно вкладке «Опасная зона» внутри модального окна (см. ниже).

Публичность — вне модального окна

Переключатель публичности проекта расположен не в модальном окне, а в шапке страницы профиля — отдельный селект «Публичный / Закрытый». Это сделано для быстрого изменения статуса без открытия настроек.

Четыре вкладки внутри модального окна

• Основное — информация о проекте, экспорт, ограничения качества.
• Viewer UI — оформление 360°‑просмотрщика панорам.
• Доступ — соавторы проекта (показывается только при наличии прав).
• Опасная зона — удаление проекта.

Базовые поля и экспорт. Расположение полей сверху вниз:

• Название и Слаг — в две колонки. Слаг используется в URL публичного тура.
• Описание — текстовое поле для краткого описания проекта. Если включён ИИ, рядом появляется кнопка «ИИ» — она автоматически генерирует описание на основе содержимого тура.
• Блок «Экспорт» — рамочная карточка с двумя кнопками: ZIP‑экспортом и обновлением public‑бандла (подробнее в разделе ZIP‑экспорт).
• Макс. разрешение (Skybox) — селект 1k / 2k / 4k. Подсказка: «Ограничивает максимальный размер кубмапов для 3D‑экспорта».
• Макс. разрешение (Walk) — селект 1k / 2k / 4k. Подсказка: «Ограничивает максимальное качество тайлов панорамы».
• Если проект публичный — чекбокс «Показывать в галерее на главной». Иначе чекбокс скрыт.
• Внизу — кнопка «Сохранить».

Список сцен в экспорте

Чекбокс «Показывать список сцен в экспорте» — управляет отображением ленты сцен в нижней части просмотрщика панорам.

Логотип проекта

Отдельный логотип проекта — общая марка профиля для брендирования. Он работает независимо от логотипа, заданного в 3D Студии (Дизайн → Логотип) — там логотип привязан к конкретному 3D‑туру.

Кнопки управления (для 360°‑Pano)

Карточка с восемью чекбоксами:

• zoom — зум
• autoRotate — авто‑вращение
• fullscreen — полный экран
• vr — VR‑режим
• share — поделиться
• info — инфо‑карточка
• minimap — миникарта
• sceneList — список сцен

Под чекбоксами — кнопка «Сброс», возвращающая дефолтный набор.

Цветокоррекция (для 360°‑Pano)

Карточка с четырьмя ползунками, каждый диапазон 0…2, шаг 0.05, дефолт 1.0:

• Яркость
• Гамма
• Насыщенность
• Контраст

Кнопка «Сброс» — возвращает все четыре значения к 1.0.

Вкладка «Доступ» показывается, только если у пользователя есть право управлять соавторами (canManageCollaborators === true).

Соавторы проекта

Здесь можно пригласить других пользователей VPano для совместной работы над проектом: они получают доступ к 3D Студии, редактору панорам и медиатеке.

Тарифные ограничения

Если в тарифе пользователя maxCollaboratorsPerProject === 0, вверху вкладки появляется красный (destructive) баннер: «Ваш тариф не поддерживает совместный доступ» с подсказкой про повышение тарифа.

При ненулевом лимите ниже отображается список слотов соавторов с кнопками добавления и удаления.

Внутри вкладки «Основное» в рамочной карточке «Экспорт» доступны два разных действия:

Кнопка «Экспорт 3D‑тура (ZIP)»

Скачивание готового 3D‑тура единым ZIP‑архивом для размещения на любом веб-хостинге.

1. Подтвердите экспорт в открывшемся диалоге.
2. Сервер выдаёт одноразовый токен (1x‑token).
3. Браузер скачивает архив по URL /api/dl/3d/<profileId>?dltoken=….

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

• Все панорамы в формате WebP (skybox‑кубмапы).
• 3D‑модель в формате GLB.
• Готовый viewer‑бандл — HTML / CSS / JavaScript.
• Все теги, навигация, дизайн и настройки тура.

Тарифные ограничения

• Кнопка экспорта проверяет флаги isLocked и global3dExportEnabled: экспорт доступен админам, либо при включённом флаге на стороне пользователя.
• Если экспорт не разрешён или проект заблокирован, компонент кнопки (ExportButton) показывает Pay‑CTA вместо скачивания — ошибка PLAN_3D_EXPORT_DENIED.
• Заблокированный проект (тариф закончился) выдаёт PROJECT_LOCKED и тоже ведёт на повышение тарифа.

Требования к хостингу

• Любой статический веб‑сервер: Apache, Nginx, S3, Cloudflare Pages — Node.js и БД не нужны.
• HTTPS обязателен для работы VR‑режима (WebXR требует безопасного контекста).
• Аккаунт VPano и связь с сервером после развёртывания не требуются — тур полностью автономен.

Кнопка «Обновить 3D public export»

Вторая кнопка рядом с ZIP — обновление публичного бандла тура. Это не скачивание, а пересборка публичной версии на сервере.

• Пересобирает бандл по пути /exports/project3d/<id>/public/.
• После сборки сразу открывает обновлённую публичную версию тура в новом вкладке браузера.
• Доступна только пользователям с правом экспорта (та же проверка флагов).

Когда нужна

После изменений в 3D Студии (теги, дизайн, сцены) опубликованная версия тура может оставаться старой до явной пересборки. Эта кнопка форсирует обновление public‑бандла, чтобы изменения сразу появились по публичной ссылке.

Публичный 3D‑тур открывается быстро даже на слабом соединении за счёт прогрессивной подгрузки: сначала превью, затем полноценные тайлы. Параметры, влияющие на скорость, лежат в «Основное».

• Skybox‑MaxRes — потолок разрешения для экспорта кубмапов (ZIP). На скорость работы в Студии не влияет.
• Walk‑MaxRes — потолок качества для live‑тайлов в просмотрщике. Влияет на скорость загрузки сцены при прогулке.

Подробнее о том, как работает прогрессивная подгрузка тайлов и переключения Walk↔Skybox — в Режим прогулки (Walk).

Последняя вкладка модального окна — «Опасная зона». Внутри — красная (destructive) карточка с заголовком «Удаление проекта» и кратким предупреждением: «Проект будет удалён вместе со всеми панорамами и файлами».

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

• Все панорамы и тайлы.
• 3D‑модель и связанные ассеты (медиатека по проекту).
• Все теги, экскурсии, настройки дизайна.
• Public‑бандл и записи об экспортах.

• Имена панорам не совпадают с pano_N — авто‑назначение слотов не сработает, файлы попадут в «Неназначенные». См. Режим прогулки и Экспорт.
• Где «Сохранить старт»? — стартовая позиция тура сохраняется не в этом модальном окне, а в шапке вьюера 3D Студии. См. Теги и сцены → Стартовая позиция.
• Неверные размеры в измерениях — калибровка инструмента фиксирована (1.0). Если мерки выходят неправильными, откройте мастер слота и выберите корректную единицу (см / мм / м / дм), либо запустите «Настройки модели» → Reprocess. Старая рекомендация «настроить калибровку» больше не актуальна.
• Ошибка PLAN_3D_EXPORT_DENIED при ZIP‑экспорте — текущий тариф не включает 3D‑экспорт. Pay‑CTA внутри кнопки ведёт на страницу повышения тарифа.
• Ошибка PROJECT_LOCKED — проект заблокирован из‑за истёкшего тарифа. После продления экспорт снова доступен.
• Изменения в Студии не видны в публичном туре — нажмите «Обновить 3D public export» рядом с ZIP‑кнопкой, чтобы пересобрать публичный бандл.