Écrire votre propre World
world.html est une simple page HTML. Tout ce que le kit de scène
ne peut pas dessiner (une machine, une pièce, un jeu, un robot personnalisé) peut être une page
à vous, écrite à la main ou par une IA.
Avec une IA
Section intitulée « Avec une IA »Appuyez sur Copy AI prompt, dans l’introduction 3D ou dans la barre World. Le prompt est un brief complet, construit à partir de votre projet à cet instant :
- Votre projet, lu depuis le canvas : chaque carte, chaque composant (avec ses réglages courts comme la couleur d’une LED), le câblage sous forme de nets (quelles broches sont reliées, y compris via les platines de prototypage), et les fichiers de firmware.
- Ce qu’un World peut lire et écrire, pour les composants que vous avez et pour chaque composant qu’un World prend en charge, afin que l’IA puisse vous indiquer quel composant ajouter et comment le câbler.
- Les règles : où la page s’exécute, l’API
window.velxio, la physique sur le temps simulé, et les deux façons d’écrire un World (une scène de kit ou une page libre). - Comment répondre : le
world.htmlcomplet, le nouveau firmware s’il doit changer, et les modifications de câblage broche par broche.
Collez-le dans ChatGPT, Claude, Gemini ou tout autre chat, et écrivez à la fin ce que vous voulez construire, dans n’importe quelle langue. Par exemple, avec un ESP32 et quatre servos sur le canvas : “un bras robotique qui prend le cube rouge et le dépose dans la boîte”. Ensuite, ouvrez le World, passez à HTML, remplacez tout par la réponse et appuyez sur Run.
Où la page s’exécute
Section intitulée « Où la page s’exécute »- Une iframe sandboxée sans accès à l’API de Velxio, à votre compte ni à vos
cookies.
localStoragepeut être absent. - Les scripts et les styles se chargent uniquement depuis
cdn.jsdelivr.net,cdnjs.cloudflare.com,unpkg.cometesm.sh, plus le code inline. three.js provient dehttps://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js. window.velxioexiste déjà lorsque vos scripts s’exécutent. C’est le seul lien vers le circuit.
L’API velxio
Section intitulée « L’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 logRègles pour un World qui se comporte bien
Section intitulée « Règles pour un World qui se comporte bien »- Physique sur le temps simulé. Additionnez
f.dtet avancez par pas fixe (2 ms fonctionne bien), en plafonnant le retard accumulé à 0,25 s. Dessinez avecrequestAnimationFrame, mais ne déplacez jamais rien en fonction du temps réel : le simulateur peut tourner plus lentement ou plus vite que le temps réel. - Ne déplacez qu’avec
f.runningà true, et remettez tout à son état initial surreset. - N’écrivez un capteur que lorsque sa valeur change, et un capteur de distance au plus toutes les 30 ms de temps simulé. Mesurez depuis la scène : échantillonnez le sol sous un capteur de ligne, lancez un rayon pour un capteur de distance.
- Associez la commande d’un moteur à la vitesse des roues avec un peu d’inertie (un retard du premier ordre d’environ 80 ms) et une petite zone morte. Un robot différentiel tourne par la différence entre ses deux côtés.
- Un seul fichier autonome qui se redimensionne avec la fenêtre et affiche les valeurs qui comptent dans une petite superposition.
Un World libre minimal
Section intitulée « Un World libre minimal »<!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>Le suiveur de ligne Romeo ESP32-S3 est un World libre complet : une scène three.js avec son propre modèle de robot, trois capteurs de ligne sur une boucle adhésive, et un URM09 qui voit une boîte que vous pouvez déposer sur la piste.