1
La guida parla
Durante un tour in Giappone la guida può parlare inglese o giapponese, mentre il gruppo preferisce ascoltare in italiano.
Case study · Dal viaggio al codiceUrania Live
Urania Live
Translator
Una web app che traduce in tempo reale la voce di una guida e condivide audio italiano e sottotitoli con tutti i partecipanti, direttamente sui loro telefoni.
Urania Live Translator
Ascolto in corso
LIVE
Italiano
“Alla vostra destra potete vedere il tempio…”
“Alla vostra destra potete vedere il tempio…”
12345
5 persone collegateDa dove siamo partiti
Un problema concreto, durante un viaggio.
L'idea non è nata da una tecnologia da provare, ma da una situazione molto semplice da risolvere.
2
Il gruppo è composto da cinque persone
Un solo telefono vicino alla guida non basta: ciascuno deve ricevere la traduzione sui propri auricolari.
3
Una traduzione, condivisa
Il telefono della guida traduce una sola volta; la web app distribuisce lo stesso audio italiano a tutto il gruppo.
Come funziona
Dalla voce a cinque paia di auricolari.
Il flusso è unico e condiviso: così non servono cinque traduzioni separate e i costi restano contenuti.
Voce della guidaInglese, giapponese o un'altra lingua riconosciuta
→
Telefono trasmettitoreCattura la voce e apre una sola sessione
→
OpenAI RealtimeComprende e restituisce voce e testo in italiano
→
WebRTC + TURNPortano l'audio ai telefoni, anche su reti differenti
12345
🔄Supabase Realtime coordina l'ingresso nella stanza, lo scambio dei collegamenti e i sottotitoli. L'audio viaggia direttamente con WebRTC.
I livelli del progetto
Ogni tecnologia ha un compito preciso.
La web app è il risultato di più componenti piccoli che collaborano, senza esporre le chiavi riservate nel browser.
Livello 01
Interfaccia web
Due percorsi essenziali: “Trasmetti” per chi è vicino alla guida e “Ascolta” per i partecipanti.
Livello 02
Traduzione in tempo reale
Una sola sessione trasforma la voce originale in audio italiano e sottotitoli.
Livello 03
Stanza e coordinamento
Codice e PIN riuniscono il gruppo; i messaggi realtime preparano il collegamento tra telefoni.
Livello 04
Distribuzione dell'audio
WebRTC trasporta il suono. Cloudflare TURN interviene quando Wi-Fi e rete mobile non riescono a comunicare direttamente.
Livello 05
Server e sicurezza
Gli endpoint PHP generano credenziali temporanee: le chiavi OpenAI e Cloudflare non finiscono su GitHub.
Come l'abbiamo realizzata
Dal primo prototipo alla prova sul campo.
Il progetto è cresciuto per iterazioni: ogni test ha indicato il problema successivo da risolvere.
Esigenza
Definizione dello scenario: una guida e cinque ascoltatori.
Primo prototipo
Creazione delle schermate Trasmetti e Ascolta.
Traduzione AI
Collegamento a OpenAI con token temporanei server-side.
Stanza condivisa
Supabase per ingresso, segnalazione e sottotitoli.
Audio ai telefoni
WebRTC distribuisce la voce tradotta al gruppo.
Test fuori dal Wi-Fi
Cloudflare TURN risolve i collegamenti tra reti diverse.
Esperienza d'uso
Grafica più calda, pulsanti grandi e utilizzo da viaggio.
Verifica finale
Controllo di costi, ritardo, privacy e sicurezza.
Il risultato
Una piccola infrastruttura da viaggio.
1sessione di traduzione
5ascoltatori simultanei
2uscite: audio + testo
0audio registrato dall'app
Sicurezza & privacy
Le chiavi restano dietro le quinte.
Una web app pubblica non deve contenere segreti. Per questo il browser riceve solo credenziali temporanee e strettamente necessarie.
Chiavi OpenAI e Cloudflare custodite sul server Aruba
Nessuna chiave riservata pubblicata su GitHub
Codice stanza e PIN trasformati in identificatori non leggibili
L'audio viene trasmesso in diretta e non archiviato dall'app
Cosa ci ha insegnato
Il progetto non finisce con “funziona”.
Un'idea nata per un viaggio, trasformata in un progetto completo.
Problema, prototipo, reti, intelligenza artificiale e soprattutto tante prove reali.
← Torna al laboratorio digitale