Embed
Una persona sul tuo sito, con due righe di HTML. La configurazione si gestisce dallo Studio e il widget vive in un iframe isolato.
Aggiungi lo script
Abilita l’embed pubblico della persona e copia il codice dalla sua scheda Embed. Sostituisci l’host con l’URL pubblico del frontend Prosopo e l’ID con quello della persona. Non serve una chiave API.
<script async src="https://prosopo.example/prosopo.js"
data-persona="ID_PERSONA_32_CARATTERI_HEX"
data-layout="floating"
data-position="right"
data-initial-state="minimized">
</script>Player inline
Inserisci lo script nel punto della pagina in cui vuoi mostrare il player. Il widget segue la larghezza del contenitore e il rapporto scelto.
<div style="max-width: 720px">
<script async src="https://prosopo.example/prosopo.js"
data-persona="ID_PERSONA_32_CARATTERI_HEX"
data-layout="inline" data-aspect="16:9"
data-initial-state="expanded"></script>
</div>Attributi dello script
Gli attributi sovrascrivono il posizionamento salvato. Aspetto, testi, colori e controlli si configurano nella scheda Embed.
| Attributo | Valori |
|---|---|
| data-persona | ID persona, obbligatorio |
| data-layout | inline | floating |
| data-position | left | right |
| data-initial-state | expanded | minimized |
| data-aspect | 16:9 | 9:16 | 1:1 |
Ricevi le azioni
Le azioni di tipo event configurate sulla persona arrivano al sito ospitante. Il loader verifica origine, iframe sorgente e ID prima di inoltrarle.
document.addEventListener("prosopo:action", ({ detail }) => {
console.log(detail.persona, detail.name);
});Microfono e pubblicazione
Servi il sito via HTTPS (localhost è ammesso in sviluppo). Consenti l’uso del microfono negli iframe nella Permissions-Policy del sito ospitante. La conversazione parte con un gesto dell’utente. Una persona privata non viene resa pubblica dagli attributi dello script.