Создание, сборка и загрузка сцены
В это разделе вы найдете пошаговую инструкцию и дополнительные рекомендации по созданию своей первой встречи в 3D. При получении доступа к SaluteJazz SDK Creator Toolkit вы получаете готовый шаблон сцены с предустановленными настройками. Этого достаточно, чтобы собрать сцену, загрузить на сервер и создать встречу в SaluteJazz XR.
Создание сцены
Чтобы создать сцену:
- Перейдите в Unity.
- Во вкладке Project, которая открыта по умолчанию, в поисковой строке введите название сцены SampleScene.
- Откройте сцену двойным нажатием по файлу SampleScene.
Сборка и загрузка сцены
Каждому пользователю SaluteJazz SDK Creator Toolkit доступна шаблонная сцена. Ниже описан пошаговый процесс как собрать эту сцену и загрузить ее на серв ер. В результате ваши сцены станут доступными для встреч в SaluteJazz в 3D-формате.
Шаг 1. Переход к доступным функциям
- Откройте вкладку ToolKit.
- В выпадающем списке выберите Build And Upload.
- В открывшемся окне выберите ToolKit Runner, откройте двойным нажатием.
- Выберите соответствующий файл. После этого отобразятся все доступные функции.
Шаг 2. Создание скриншота
- Чтобы сделать новый скриншот или обновить существующий, нажмите Create or Update Snapshot.
- Выберите в списке слева объект SnapShotMaker, с помощью которого определяется ракурс кадра. Разместите его в сцене так, чтобы получить эффектный и информативный снимок.
Шаг 3. Авторизация
- Нажмите Auth User — откроется окно Данные для входа.
- Введите логин и пароль. Если авторизация прошла успешно, в Unity под скриншотом сцены появится информация о вашем токене.
Шаг 4. Проверка и сборка сцены
- Перед загрузкой проверьте сцену на ошибки, нажав Check Errors Before Build.
- Если все в порядке, запустите сборку кнопкой Build.
В составе SDK предусмотрено окно отладки оптимизации для контроля параметров, играющих важную роль в оптимизации сцены. Открыть его можно через главное меню: Toolkit → Optimization Debugger. Используйте его для перед тем как собрать сцену. Окно включает следующие ключевые элементы:
- Главное окно отладчика, позволяющее выбрать режим работы и определить, какие именно параметры должны собираться и отображаться.
- Плавающая панель во вкладке Scene, содержащая детальную информацию о каждом параметре, критичном для оптимизации производительности сцены.
Весь список ошибок препятствующих сборке сцены представлен в таблице ниже.
| Название теста | Описание теста | Категория |
|---|---|---|
| URPIsRequred | Необходимо использовать URP-профиль | Error |
| NoDependencyInScene | Отсутствует BaseRealmDependencies на сцене | Error |
| CheckIfPolygonIsConvex | Проверка выпуклый ли полигон для разрешенной игровой зоны | Error |
| DefaultPlacementsNotSet | В Dependecies всегда должны быть значения: AimingPlacementAnchor, DefaultPlacementAnchor, SpeakerAimingAnchor — для размещения пользователей на сцене | Error |
| NoNavMeshFound | Отсутствует компонент NavMesh (только если хотя бы один SeatHotSpot назначен в Dependency) | Error |
| SpawnZoneIsTouchingRespawnTrigger | Все точки спавна должны не должны касаться RespawnTrigger | Error |
| SpawnZoneOutOfAllowedZone | Все точки спавна должны быть внутри AllowedZone | Error |
| NoDependencyInScene | Отсутствует BaseRealmDependencies на сцене | Error |
| NoSpawnZoneExisted | В Dependency не назначена ни одна точка спавна | Error |
| NoSnapShotMakerInScene | Отсутствует компонент SnapShotMaker для превью изображения на сцене | Error |
| NoClipsAllowedInAudioSources | Не должно быть звуков по умолчанию в AudioSource | Error |
| ClipsWithPreloadAudioDataFound | Нельзя чтобы в проекте были AudioClip с включенным параметром импорта PreloadAudioData | Error |
| SeatHotSpotIdNotUnique | Точка для сидения имеет не уникальный идентификатор | Error |
| NotEnoughPlacements, NeedMorePlacements, RecommendedMorePlacements | Не назначены позиции Placements спауна участников в режиме конференции | Error < 10, Warning < 25, Info < 50 |
| NotEnoughSpeakerPlacements, NeedMoreSpeakerPlacements | Не назначены позиции SpeakerPlacements спауна спикеров в режиме конференции | Error < 5, Warning < 10 |
| NoSeatHotSpotSet | Не назначены SeatHotSpot сидячие позиции | Info |
| NoVideoShareViews | Не назначен ни один экран VideoShareViews для повтора видео или презентации | Info |
| PlacementInfoNotUsed | Не назначен никуда объект с компонентом PlacementInfo (Speaker\Default) | Info |
| NoAllowedTeleportSurfaces | Не найдено поверхностей по которым можно телепортироваться (слой AllowTeleport) | Info |
| PlayerRespawnTriggerNotSet | В Dependency не назначено ни одного триггера респавна | Info |
| VideoShareViewsNotUsed | Объект не назначен ни в один компонент настройки (VideoShareViews) | Info |
| SpawnZoneNotSetToDependecies | Зона спавна не назначена в Dependencies | Info |
| SoundPlayableViewNotUsed | Объект с настройкой звука не назначен в Dependencies | Info |
| NoSpeakerSpawnPoints | Добавьте SpeakerSpawnArea места для спикеров чтобы во время презентации была возможность поместить спикера | Warning |
| NoBakedLightsFound | В сцене не использовано запечение света Lightmap | Warning |
| ArtLimitsExceeded | Превышены рекомендуемые параметры — количество материалов, рендереров, общий размер текстур | Warning |
| PlayerAllowedZoneNotSet | В Dependencies не назначена разрешенная игровая зона | Warning |
| PLayerRespawnTriggerMissingIsTriggerOnCollider | У триггера респавна игрока не установлен флаг isTrigger | Warning |
Шаг 5. Выбор слота и загрузка
- Выберите свободный слот для загрузки. Свободные слоты внизу окна в виде картинок. Если список не отображается, обновите его кнопкой Update Slots.
- В слоте выберите вариант загрузки сцены. Доступные варианты загрузки:
- Удалить и загрузить новую версию (удаляются все платформы WebGL и VR).
- Загрузить новую версию на сервер (обновляется только выбранная версия платформы).
- Выберите нужный вариант и нажмите Upload. Для подтверждения появится окно с запросом — это страховка от случайных действий.
Ваша сцена теперь доступна для проведения конференций в 3D-режиме.
Шаг 6. Создание 3D-встречи в SaluteJazz
После того как сцена успешно собрана и загружена, она становится доступной для проведения встреч. Чтобы создать встречу:
- Откройте веб-версию SaluteJazz или десктоп-приложение.
- Нажмите кнопку Создать встречу.
- В появившемся меню выберите 3D-пространство.
- Найдите созданную вами сцену, выберите ее и нажмите Создать и присоединиться.
Сцену можно сделать доступной для создания встреч для всех администраторов вашей корпоративной лицензии. Для этого:
- На главной странице в левом боковом меню перейдите во вкладку Управление.
- В открывшемся меню найдите нужную сцену и нажмите кнопку Публиковать. После этого она станет общедоступной для пользователей с ролью «Администратор».
