Интеграция TexelKit API
Полный технический справочник для разработчиков. Подключайте наши WebGL-движки, настраивайте PBR-материалы и внедряйте иммерсивные витрины в ваши приложения за считанные часы.
Быстрый старт
Для начала работы с TexelKit вам понадобится API-ключ и среда разработки, поддерживающая Node.js 18+ или современные браузеры с поддержкой WebGL 2.0.
1. Регистрация
Получите токен доступа в личном кабинете разработчика. Токен используется для аутентификации всех запросов к облачному рендеру.
2. Инициализация
Импортируйте пакет в ваш проект. Библиотека автоматически определит уровень поддержки графики устройства.
const engine = new TexelEngine({
apiKey: 'tk_live_8f92...',
canvas: '#showroom-container',
quality: 'ultra'
});
engine.loadScene('luxury_v1.json');
Текстуры и Материалы
Методы для динамической подгрузки PBR-карт и управления физическими свойствами поверхности.
/api/v2/materials
Возвращает список доступных материалов для текущей сцены. Поддерживает фильтрацию по типу (ткань, металл, камень).
/api/v2/texture/upload
Загрузка пользовательских текстур (PNG/JPG/EXR). Сервер автоматически генерирует карту нормалей и roughness-карту.
/api/v2/scene/lighting
Изменение параметров освещения в реальном времени. Позволяет настроить угол падения света для акцентирования фактуры.
WebGL и WebGL2 оптимизация
TexelKit использует адаптивный рендеринг, который подстраивает качество полигонов и сглаживание (MSAA) под возможности устройства пользователя.
LOD Система
Автоматическое переключение уровней детализации (Level of Detail) при изменении масштаба или скорости вращения камеры. Снижает нагрузку на GPU на 40%.
Texture Streaming
Потоковая передача текстур. Высокодетализированные карты загружаются только тогда, когда объект попадает в центр экрана.
Instancing
Массовое рендеринг повторяющихся элементов (например, пуговиц на ткани) через GPU Instancing для максимальной производительности.
Скачать SDK
Выберите платформу для интеграции. Все пакеты включают исходные коды примеров и файлы TypeScript.
Статус API и Известные ошибки
Известные проблемы (v2.4.1)
- При загрузке текстур размером > 8K на мобильных устройствах iOS может происходить падение FPS. Рекомендуется использовать компрессию ASTC.
- Некорректное отображение теней в Firefox ESR при отключенном WebGL2 (используется фоллбек).
Нужна помощь с кодом?
Присоединяйтесь к нашему Slack-каналу для разработчиков или свяжитесь с инженерной поддержкой.