Загрузка 3D-модели в Pro
В XIOT-EDITOR Pro можно разместить 3D-модель на дополнительной странице интерфейса. Для загрузки нужен ZIP-архив с моделью Collada (.dae) и её текстурами. Один файл .dae без необходимых изображений не заменяет такой архив.
Инструкция предназначена интегратору с доступом к редактированию проекта. Основные инструменты описаны в обзоре режима Pro.
Подготовьте модель
- В программе моделирования экспортируйте модель в формат Collada (.dae) вместе с текстурами.
- Сохраните файл модели и полученную при экспорте папку с изображениями рядом.
- Не переименовывайте и не перемещайте текстуры после экспорта: внутри
.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
- Откройте проект и переключитесь в Pro. Если включён просмотр, перейдите в режим редактирования клавишей F2.
- Откройте нужную страницу. Добавьте в неё блок через контекстное меню рабочей области или выберите уже существующий блок для модели.
- В правой панели свойств откройте Тип элемента и выберите 3D блок. Задайте видимые ширину и высоту блока.
- В настройках 3D выберите подготовленный файл
.zipи нажмите Загрузить. - Дождитесь окончания загрузки и появления модели. Большая модель может обрабатываться дольше небольшого изображения.
- Проверьте геометрию и материалы: стены, пол и другие поверхности должны отображаться с нужными текстурами.
После загрузки настройте ракурс и сохраните положение камеры в свойствах 3D-элемента. При следующем открытии применяется первый сохранённый ракурс. Если модель не попадает в видимую область, проверьте её масштаб и положение относительно начала координат, размеры блока и ракурс камеры: автоматическое кадрирование всей модели не выполняется.
Сохраните результат
После проверки модели сохраните проект обычной командой редактора. Если вы отключили автоматическую отправку в облако, для передачи результата в приложение используйте отдельную кнопку Опубликовать изменения. Перед передачей заказчику проверьте страницу на устройстве, для которого она предназначена.
Подробнее: Сохранение резервной копии проекта.
Если загрузка не удалась
«Collada archive is missing a referenced texture»
Загрузчик не нашёл изображение по ссылке, записанной в модели. Это не всегда означает, что самого файла нет.
- Откройте ZIP и убедитесь, что папка текстур попала внутрь полностью.
- Проверьте, что имена, регистр букв и вложенность папок не изменились после экспорта.
- Если все изображения на месте, а имена содержат кириллицу, заново создайте ZIP с именами UTF-8. Некоторые архивы сохраняют русские имена способом, который загрузчик распознаёт неверно.
- Если архиватор не позволяет выбрать UTF-8, повторите экспорт под коротким именем латиницей, затем упакуйте заново всю полученную пару: модель и папку текстур.
Не удаляйте ссылки на изображения внутри модели ради обхода сообщения: так можно потерять её материалы.
«В корне 3D-архива должен быть один файл DAE»
Уберите лишнюю внешнюю папку при упаковке. В ZIP должен быть один .dae на верхнем уровне, а не несколько моделей и не только папка с ними.
Сообщение о неподдерживаемом файле или повреждённом ZIP
Повторно упакуйте только модель и её текстуры, без служебных файлов и пароля. Обычная смена расширения архива на .zip не меняет его формат.