Table of contents

Настройки виджета на сайте. Файлы конфигурации

Файл WidgetConfig.json отвечает за отображение интерфейса виджета и находится в корневой папке с виджетом

Настройки интерфейса находятся в файле WidgetConfig.json:

1. Ключ "showLogo". Значение true включает отображение лого компании, значение false выключает отображение лого компании.

2. Ключ "showSizePanel". Значение true включает отображение панели размеров,  значение false выключает отображение панели размеров. 

3. Ключ "showModelsPanel". Значение true включает отображение панели с выбором моделей, значение false выключает отображение панели с выбором моделей

4. Ключ "showMaterialsPanel". Значение true включает отображение панели материалов, значение false выключает отображение панели материалов  

5. Ключ "showLoadModelButton". Значение true включает отображение кнопки для загрузки пользовательских моделей в формате .glb, значение false выключает отображение кнопки для загрузки пользовательских моделей

6. Ключ "showArButton". Значение true включает отображение кнопки просмотра модели в AR, значение false выключает отображение кнопки просмотра модели 

Пример:

В файле ModelsConfig.json находятся настройки освещения виджета. Сам файл находится в корневой папке с виджетом

Настройки освещения находятся в файле ModelsConfig.json:

1. Ключ "exposure". В данном ключе можно установить числовое значение, влияющее на яркость освещения в виджете при просмотре модели

2. Ключ "shadowIntensity". В данном ключе можно установить числовое значение, влияющее на интенсивность тени в виджете при просмотре модели

3. Ключ "shadowSoftness". В данном ключе можно установить числовое значение, влияющее на мягкость тени в виджете при просмотре модели

Пример:

В файле ModelsConfig.json указываются пути к файлам моделей, конфигурации и изображений. Сам файл находится в корневой папке с виджетом

Общая конфигурация моделей представляет собой массив объектов в .json файле, где каждый объект имеет набор свойств:

1. Ключ "source". В данном ключе находится путь к файлу модели

2. Ключ "poster". В данном ключе находится путь к изображению, которое будет показано во время загрузки модели

3. Ключ "scale". В данном ключе находится числовое значение размера модели

4. Ключ "orientation". В данном ключе находится числовое значение поворота модели по трем осям в градусах

5. Ключ "buttonImg". В данном ключе находится путь к картинке, отображаемой на нижней панели

6. Ключ "materialsConfig". В данном ключе находится путь к файлу конфигурации

В данном файле нужно вручную указать путь к файлам моделей, конфигурации и изображений, которые Вы поместили в папку с виджетом

Пример:

Файл конфигурации с моделями должен располагаться в папке с виджетом и называться ModelsConfig.json. При запуске виджета данный файл считывается и отображаются модели, указанные в нем (если при запуске виджета в строке браузера указана конкретная модель, то отобразится она).

Файлы конфигурации моделей отвечают за настройку конкретных моделей и находятся в папках models и presets виджета (формат файлов .json). Файлы моделей, конфигурации и изображений нужно вручную разместить в папке models 

Файл конфигурации модели выгружается из программы AllMebel3d сразу после экспорта модели в формате glb. Его необходимо разместить по пути указанному в "materialsConfig" из пункта Общая конфигурация моделей. Опционально в конфигурацию можно добавить ключ "hotspotViewMode". Он отвечает за значки с информацией на моделях. Значения ключа: 0 - значки выключены, 1 - отображаются названия моделей, 2 - отображаются значки с информацией.

В файле конфигурации модели есть следующие свойства:

1. Ключ "name". В данном ключе находится имя модели

2. Ключ "metallic". В данном ключе находится числовое значение металлика материала

3. Ключ "roughness". В данном ключе находится числовое значение шероховатости материала

4. Ключ "color". В данном ключе находятся числовые значения цвета материала по каналам r(красный), g(зеленый), b(синий), a(прозрачность)

5. Ключ "worldPosition". В данном ключе находятся числовые значения положения модели в координатах сцены по осям x, y, z

6. Ключ "exportData". В данном ключе находятся данные о модели, полученные при экспорте модели из программы AllMebel3d 

Файл конфигурации экспортированной модели можно редактировать, например, с помощью блокнота. Меняя значения ключей, можно изменить итоговый вид модели и ее расположение в виджете.

Пример файла конфигурации модели:

*Примечание. При изменении файла конфигурации модели есть риск получить ошибки в виджете.

☝️
Внимание!
Для того, чтобы на моделях отображались описательная информация и значок "i" нужно в файле конфигурации к конкретной модели добавить название фабрики, к которой относится эта модель. Фабрик может быть несколько. В файле .json в массиве "companyNames" нужно вписать в кавычках название фабрики (если фабрик несколько, то пишутся названия в кавычках через запятую, например, "Дома Дом", "Стиль")

Изображения, используемые для значков и иконок в виджете хранятся в корневой папке и папке models в формате .png

Файлы с выгруженными из AllMebel3d моделями хранятся в папке models в формате .glb