编写你自己的 World
world.html 是一个普通的 HTML 页面。场景套件无法绘制的任何内容(一台机器、一个房间、一个游戏、一个自定义机器人)都可以是你自己的页面,可以手写,也可以由 AI 编写。
在 3D 介绍中或 World 栏中按 Copy AI prompt(复制 AI 提示词)。该提示词是一份完整的简报,根据你当时的项目构建:
- 你的项目,从画布读取:每块板、每个部件(带有简短设置,例如 LED 的颜色)、作为网络的接线(哪些引脚相连,也包括通过面包板连接的),以及固件文件。
- World 可以读写什么,针对你拥有的部件以及 World 支持的每个部件,这样 AI 就能告诉你该添加哪个部件以及如何接线。
- 规则:页面在哪里运行、
window.velxioAPI、基于模拟时间的物理,以及编写 World 的两种方式(套件场景或自由页面)。 - 如何回答:完整的
world.html、需要更改时的新固件,以及逐引脚的接线更改。
将其粘贴到 ChatGPT、Claude、Gemini 或任何其他聊天工具中,并在末尾用任何语言写下你想构建的内容。例如,画布上有一个 ESP32 和四个舵机:“一个拿起红色方块并将其放入盒子中的机械臂”。然后打开 World,切换到 HTML,用答案替换所有内容并按 Run(运行)。
页面在哪里运行
Section titled “页面在哪里运行”- 一个沙盒化的 iframe,无法访问 Velxio 的 API、你的账户或你的 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已经存在。它是与电路之间的唯一链接。
velxio API
Section titled “velxio API”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 的规则
Section titled “行为良好的 World 的规则”- 基于模拟时间的物理。 累加
f.dt并以固定步长推进(2 ms 效果不错),将积压限制在 0.25 s。使用requestAnimationFrame绘制,但绝不要按墙钟时间移动任何东西:模拟器可能比实时运行得更慢或更快。 - 仅在
f.running为 true 时移动,并在reset时将所有内容恢复到起始状态。 - 仅在传感器的值发生变化时写入,距离传感器最多每 30 ms 模拟时间写入一次。从场景中测量:在线传感器下方采样地面,为距离传感器投射射线。
- 将电机的驱动映射到轮速,带一点惯性(约 80 ms 的一阶滞后)和一个小死区。差速机器人通过两侧之差来转向。
- 一个自包含的文件,随窗口调整大小,并在一个小覆盖层中显示重要的读数。
一个最小的自由 World
Section titled “一个最小的自由 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 循线机器人是一个完整的自由 World:一个带有自己机器人模型的 three.js 场景、一个贴有胶带的环路上的三个线传感器,以及一个能看到你可以放在赛道上的盒子的 URM09。