Напишите свой собственный World
world.html — это обычная HTML-страница. Всё, что набор сцен
не может нарисовать (станок, комната, игра, нестандартный робот), может быть страницей,
написанной вами вручную или с помощью ИИ.
С помощью ИИ
Заголовок раздела «С помощью ИИ»Нажмите Copy AI prompt в разделе 3D introduction или на панели World. Этот промпт — полное техническое задание, собранное из вашего проекта на данный момент:
- Ваш проект, считанный с холста: каждая плата, каждая деталь (с краткими настройками, например, цветом светодиода), соединения в виде цепей (какие выводы соединены, в том числе через макетные платы), и файлы прошивки.
- Что World может читать и записывать, для имеющихся у вас деталей и для каждой детали, которую поддерживает World, чтобы ИИ мог подсказать, какую деталь добавить и как её подключить.
- Правила: где выполняется страница, API
window.velxio, физика на моделируемом времени, и оба способа написания World (сцена из набора или свободная страница). - Как отвечать: полный
world.html, новая прошивка, если её нужно изменить, и изменения в подключении вывод к выводу.
Вставьте его в ChatGPT, Claude, Gemini или любой другой чат и в конце напишите, что хотите построить, на любом языке. Например, с ESP32 и четырьмя сервоприводами на холсте: “робот-манипулятор, который берёт красный куб и кладёт его в коробку”. Затем откройте World, переключитесь на HTML, замените всё ответом и нажмите Run.
Где выполняется страница
Заголовок раздела «Где выполняется страница»- Песочница iframe без доступа к API Velxio, вашему аккаунту или вашим
cookie.
localStorageможет отсутствовать. - Скрипты и стили загружаются только с
cdn.jsdelivr.net,cdnjs.cloudflare.com,unpkg.comиesm.sh, плюс встроенный код. three.js берётся сhttps://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js. window.velxioуже существует, когда выполняются ваши скрипты. Это единственная связь со схемой.
API velxio
Заголовок раздела «API velxio»const info = await velxio.ready();// { boards: [{ id, kind }],// parts: [{ id, type, board, outputs: [...], inputs: [{ key, kind, min, max, unit }] }],// theme: 'dark' | 'light' }
velxio.onFrame((f) => { // about 125 times per second // f.t simulated seconds since the board booted (null while stopped) // f.dt simulated seconds since the previous frame // f.running true while the firmware runs // f.parts { [id]: { drive, rpm } } for motors, { [id]: { angle } } for servos, // { [id]: { on, brightness } } for LEDs});
velxio.set(partId, values); // write a sensor: only the keys it lists, values clampedvelxio.press(partId); // pushbuttons and switchesvelxio.release(partId);velxio.on('reset', fn); // the firmware restarted: put the world back at its startvelxio.on('theme', fn); // Velxio switched between dark and lightvelxio.on('visibility', fn); // stop drawing while hidden, keep the physics on framesvelxio.telemetry({ ... }); // optional state to show in Velxioconsole.log(...); // goes to the World logПравила для правильно работающего World
Заголовок раздела «Правила для правильно работающего World»- Физика на моделируемом времени. Суммируйте
f.dtи выполняйте шаги с фиксированным шагом (2 мс подходит хорошо), ограничивая накопленное значение 0.25 с. Рисуйте с помощьюrequestAnimationFrame, но никогда не перемещайте ничего по реальному времени: симулятор может работать медленнее или быстрее реального времени. - Двигайте что-либо только пока
f.runningравно true, и возвращайте всё в исходное состояние поreset. - Записывайте показания датчика только при изменении его значения, а датчика расстояния не чаще, чем каждые 30 мс моделируемого времени. Измеряйте по сцене: опрашивайте пол под датчиком линии, пускайте луч для датчика расстояния.
- Сопоставляйте drive мотора со скоростью колеса с небольшой инерцией (апериодическое звено первого порядка около 80 мс) и небольшим мёртвым диапазоном. Дифференциальный робот поворачивает за счёт разницы между двумя его сторонами.
- Один самодостаточный файл, который подстраивается под размер окна и показывает важные показания в небольшом оверлее.
Минимальный свободный World
Заголовок раздела «Минимальный свободный World»<!doctype html><html><head> <meta name="viewport" content="width=device-width, initial-scale=1"> <style>html,body{margin:0;height:100%;overflow:hidden;background:#15171a;color:#ddd;font:12px system-ui}</style></head><body> <script type="module"> const info = await velxio.ready(); // build the scene from info.parts ... const STEP = 0.002; let acc = 0; velxio.onFrame((f) => { if (!f.running) return; acc = Math.min(acc + f.dt, 0.25); while (acc >= STEP) { // step the physics: read f.parts[id].drive or f.parts[id].angle acc -= STEP; } // velxio.set('<sensor id>', { ... }) when a reading changed }); velxio.on('reset', () => { /* back to the start */ }); // requestAnimationFrame loop: draw only </script></body></html>Romeo ESP32-S3 line follower — это полный свободный World: сцена three.js с собственной моделью робота, тремя датчиками линии на замкнутой трассе из ленты и URM09, который видит коробку, которую можно поставить на трассу.