Scrivi il tuo World
world.html è una semplice pagina HTML. Tutto ciò che il scene kit
non riesce a disegnare (una macchina, una stanza, un gioco, un robot personalizzato) può essere una pagina
tua, scritta a mano o da un’AI.
Con un’AI
Sezione intitolata “Con un’AI”Premi Copy AI prompt, nell’introduzione 3D o nella barra del World. Il prompt è un brief completo, costruito dal tuo progetto in quel momento:
- Il tuo progetto, letto dal canvas: ogni board, ogni componente (con impostazioni brevi come il colore di un LED), il cablaggio come reti (quali pin sono collegati, anche attraverso breadboard) e i file del firmware.
- Cosa un World può leggere e scrivere, per i componenti che hai e per ogni componente che un World supporta, così l’AI può dirti quale componente aggiungere e come cablarlo.
- Le regole: dove viene eseguita la pagina, l’API
window.velxio, la fisica sul tempo simulato e entrambi i modi di scrivere un World (una scena del kit o una pagina libera). - Come rispondere: il
world.htmlcompleto, il nuovo firmware se deve cambiare, e le modifiche al cablaggio pin per pin.
Incollalo in ChatGPT, Claude, Gemini o qualsiasi altra chat, e scrivi cosa vuoi costruire alla fine, in qualsiasi lingua. Per esempio, con un ESP32 e quattro servo sul canvas: “un braccio robotico che prende il cubo rosso e lo lascia nella scatola”. Poi apri il World, passa a HTML, sostituisci tutto con la risposta e premi Run.
Dove viene eseguita la pagina
Sezione intitolata “Dove viene eseguita la pagina”- Un iframe in sandbox senza accesso all’API di Velxio, al tuo account o ai tuoi
cookie.
localStoragepotrebbe mancare. - Script e stili si caricano solo da
cdn.jsdelivr.net,cdnjs.cloudflare.com,unpkg.comeesm.sh, più il codice inline. three.js proviene dahttps://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js. window.velxioesiste già quando i tuoi script vengono eseguiti. È l’unico collegamento al circuito.
L’API velxio
Sezione intitolata “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 logRegole per un World che si comporta bene
Sezione intitolata “Regole per un World che si comporta bene”- Fisica sul tempo simulato. Somma
f.dte avanza con un passo fisso (2 ms funziona bene), limitando l’arretrato a 0,25 s. Disegna conrequestAnimationFrame, ma non muovere mai nulla in base al tempo reale: il simulatore può andare più lento o più veloce del tempo reale. - Muovi solo mentre
f.runningè true, e riporta tutto al suo stato iniziale sureset. - Scrivi un sensore solo quando il suo valore cambia, e un sensore di distanza al massimo ogni 30 ms di tempo simulato. Misura dalla scena: campiona il pavimento sotto un sensore di linea, lancia un raggio per un sensore di distanza.
- Mappa la drive di un motore alla velocità della ruota con un po’ di inerzia (un ritardo del primo ordine di circa 80 ms) e una piccola zona morta. Un robot differenziale gira per la differenza tra i suoi due lati.
- Un unico file autonomo che si ridimensiona con la finestra e mostra le letture che contano in un piccolo overlay.
Un World libero minimale
Sezione intitolata “Un World libero minimale”<!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>Il Romeo ESP32-S3 line follower è un World libero completo: una scena three.js con il suo modello di robot, tre sensori di linea su un percorso tracciato con nastro e un URM09 che vede una scatola che puoi lasciare cadere sulla pista.