Перейти к содержанию

Загрузка 3D-модели в Pro

Материал из XIOT Wiki

В XIOT-EDITOR Pro можно разместить 3D-модель на дополнительной странице интерфейса. Для загрузки нужен ZIP-архив с моделью Collada (.dae) и её текстурами. Один файл .dae без необходимых изображений не заменяет такой архив.

Инструкция предназначена интегратору с доступом к редактированию проекта. Основные инструменты описаны в обзоре режима Pro.

Подготовьте модель

  1. В программе моделирования экспортируйте модель в формат Collada (.dae) вместе с текстурами.
  2. Сохраните файл модели и полученную при экспорте папку с изображениями рядом.
  3. Не переименовывайте и не перемещайте текстуры после экспорта: внутри .dae записаны ссылки на их имена и расположение.

Исходные файлы других форматов, например .skp, .obj или .glb, нельзя просто переименовать в .dae. Нужен именно экспорт в Collada.

Для совместимости проще задать короткое имя модели латиницей до экспорта, например house. Если используются русские имена, создавайте ZIP с именами файлов в UTF-8. Не исправляйте проблему переименованием одной папки: ссылки внутри модели тоже должны соответствовать результату экспорта.

Соберите ZIP

В корне архива должен находиться ровно один файл .dae. Рядом разместите папку текстур, сохранив структуру экспорта. Например:

house.zip
├── house.dae
└── house/
    ├── wall.jpg
    ├── floor.jpg
    └── glass.png

Имя папки house приведено для примера: используйте то, на которое ссылается ваша модель.

  • Выделяйте для упаковки сам .dae и папку текстур, а не внешнюю папку, в которой они лежат. При открытии ZIP файл модели должен быть виден сразу.
  • Не добавляйте в архив исходники проекта моделирования, другой ZIP, второй .dae и служебные файлы вроде .DS_Store или __MACOSX/._....
  • Не устанавливайте пароль на архив.
  • Максимальный размер выбранного ZIP в редакторе — 48 МБ. Для тяжёлой модели уменьшите детализацию и размеры текстур, затем повторите экспорт.

Загрузите модель в Pro

  1. Откройте проект и переключитесь в Pro. Если включён просмотр, перейдите в режим редактирования клавишей F2.
  2. Откройте нужную страницу. Добавьте в неё блок через контекстное меню рабочей области или выберите уже существующий блок для модели.
  3. В правой панели свойств откройте Тип элемента и выберите 3D блок. Задайте видимые ширину и высоту блока.
  4. В настройках 3D выберите подготовленный файл .zip и нажмите Загрузить.
  5. Дождитесь окончания загрузки и появления модели. Большая модель может обрабатываться дольше небольшого изображения.
  6. Проверьте геометрию и материалы: стены, пол и другие поверхности должны отображаться с нужными текстурами.

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

Сохраните результат

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

Подробнее: Сохранение резервной копии проекта.

Если загрузка не удалась

«Collada archive is missing a referenced texture»

Загрузчик не нашёл изображение по ссылке, записанной в модели. Это не всегда означает, что самого файла нет.

  1. Откройте ZIP и убедитесь, что папка текстур попала внутрь полностью.
  2. Проверьте, что имена, регистр букв и вложенность папок не изменились после экспорта.
  3. Если все изображения на месте, а имена содержат кириллицу, заново создайте ZIP с именами UTF-8. Некоторые архивы сохраняют русские имена способом, который загрузчик распознаёт неверно.
  4. Если архиватор не позволяет выбрать UTF-8, повторите экспорт под коротким именем латиницей, затем упакуйте заново всю полученную пару: модель и папку текстур.

Не удаляйте ссылки на изображения внутри модели ради обхода сообщения: так можно потерять её материалы.

«В корне 3D-архива должен быть один файл DAE»

Уберите лишнюю внешнюю папку при упаковке. В ZIP должен быть один .dae на верхнем уровне, а не несколько моделей и не только папка с ними.

Сообщение о неподдерживаемом файле или повреждённом ZIP

Повторно упакуйте только модель и её текстуры, без служебных файлов и пароля. Обычная смена расширения архива на .zip не меняет его формат.

См. также