Vai al contenuto
Riferimento / Prosopo Developers

Sessioni e protocollo

Dal token al primo audio: gestisci connessione, input, risposte e chiusura.

Apri il WebSocket

Connettiti al websocket_url restituito dal token. Invia subito il messaggio di handshake. Riceverai session con session_id, poi ready quando provider e slot sono disponibili. Invia input dopo ready. Il renderer SDK supportato è hybrid.

JSON
{ "session_token": "TOKEN_MONOUSO", "renderer": "hybrid" }

Messaggi in ingresso

Ogni messaggio è JSON. L’audio in ingresso usa PCM signed 16 bit little endian, mono, 24000 Hz, codificato base64. Mantieni i messaggi sotto 150000 caratteri. text e talk usano al massimo 1500 caratteri.

typeCampi
texttext: domanda per il modello
talktext: frase letta direttamente dalla voce
audioaudio: PCM base64
mutemuted: boolean
interruptNessun campo aggiuntivo
truncateitem_id, played_ms: audio effettivamente ascoltato
stopTermina la conversazione

Eventi in uscita

audio include epoch, item_id e offset_ms. Alla ricezione di clear elimina l’audio in coda e usa il nuovo epoch per ignorare pacchetti obsoleti. generation_done indica fine generazione, non necessariamente fine riproduzione audio.

EventoContenuto
session / readyID e disponibilità della sessione
listening / user_stopped / thinkingAvanzamento della conversazione
user_transcript / transcripttext utente / frammenti risposta
audio / phonemes / wordsAudio e metadati di animazione
actionAzione configurata sulla persona
clear / generation_done / usageReset, fine generazione e consumo
response_error / errorErrore recuperabile / errore di sessione

Concorrenza e riconnessione

PROSOPO_MAX_SESSIONS controlla gli slot condivisi da Studio e SDK (default 8). Quando gli slot sono occupati la connessione attende: usa il controllo indicativo di concorrenza prima dell’avvio. Dopo una disconnessione crea un nuovo token; il riuso viene rifiutato. Il registro attivo è locale al processo: usa un singolo worker per limiti e stop coerenti.