Collega la tua live IA
Come inviare la tua live IA a una piattaforma di streaming e come far arrivare la chat dei tuoi spettatori al conduttore.
- 1Noi produciamo lo streamIl tuo conduttore IA gira su una nostra macchina con GPU e trasmette uno stream video in diretta.
- 2Tu lo ricevi e lo ritrasmettiOBS o ffmpeg sul tuo computer riceve lo stream e lo invia a YouTube, Twitch, Bilibili o a qualsiasi altra piattaforma.
- 3La chat torna al conduttoreI messaggi della chat della tua piattaforma vengono passati al conduttore, che li legge e risponde a voce.
Gli indirizzi della tua live si trovano nella stanza della tua live, in «Indirizzo stream» e «Ricevi chat». Gli esempi di questa pagina usano lo stream demo gratuito, così puoi provare ogni passaggio prima di pagare.
Ogni live ha due indirizzi per la stessa immagine e lo stesso audio. Usa SRT quando puoi: regge molto meglio le lunghe distanze e le reti instabili. Usa RTMP solo se il tuo strumento non riesce ad aprire SRT.
srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000
rtmp://117.50.34.91:1935/live?user=demo&pass=d38f2f1b37
La demo è in diretta ora Gli indirizzi della demo funzionano solo mentre la demo è in diretta. Va offline per circa 15 minuti ogni volta che la macchina è occupata con un altro lavoro.
Com’è fatto l’indirizzo
srt://HOST:8890?streamid=read:live:viewer:PASSWORD&latency=300000
rtmp://HOST:1935/live?user=viewer&pass=PASSWORD
- HOST è la macchina su cui gira la tua live e PASSWORD è una password creata solo per quella sessione. Entrambi cambiano ogni volta che vai in live, quindi copia di nuovo gli indirizzi dalla stanza della tua live ogni volta.
- Chiunque abbia l’indirizzo può guardare e ritrasmettere la tua live. Non pubblicarlo.
- Lo stream è video H.264 a 25 fotogrammi al secondo con audio AAC, nel formato orizzontale o verticale che hai scelto. Può essere inviato a una piattaforma così com’è, senza ricodifica.
Verifica che si riproduca
Prima di configurare OBS, apri l’indirizzo in un lettore. Se hai installato ffmpeg, esegui questo comando (mantieni le virgolette):
ffplay -fflags nobuffer -flags low_delay "srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000"
In VLC: Media → Open Network Stream, incolla l’indirizzo RTMP, poi Play.
OBS
- In OBS aggiungi una Sorgente multimediale e deseleziona «File locale».
- Incolla l'indirizzo SRT in Input.
- In Impostazioni → Dirette inserisci il server e la chiave di trasmissione della tua piattaforma.
- Fai clic su Avvia diretta.
Se l’immagine si blocca dopo un’interruzione di rete, spunta «Restart playback when source becomes active» nella Media Source, oppure nascondi e mostra di nuovo la sorgente una volta.
ffmpeg
Dal tuo lato non serve alcuna immagine: un solo comando riceve lo stream e lo invia alla tua piattaforma. Sostituisci l’ultima parte con l’indirizzo del server e la chiave di trasmissione forniti dalla tua piattaforma.
ffmpeg -i "srt://117.50.34.91:8890?streamid=read:live:demo:d38f2f1b37&latency=300000" -c copy -f flv "rtmp://a.rtmp.youtube.com/live2/YOUR_STREAM_KEY"
Tieni aperta la finestra mentre sei in live. Lo stream resta attivo solo finché questo comando è in esecuzione.
Bilibili Live
- Apri Bilibili Live (直播姬) e aggiungi una sorgente «Stream».
- Incolla l'indirizzo RTMP.
- Avvia la trasmissione dall'app come al solito.
Il modo più semplice per ricevere la chat. Leggiamo noi la chat della tua piattaforma; non devi eseguire nulla né darci accesso al tuo account.
- Avvia la tua live qui e inizia a trasmettere sulla tua piattaforma.
- Nella stanza della tua live apri la scheda «Ricevi chat» e scegli la piattaforma.
- Incolla il nome del tuo canale Twitch o il link della tua live YouTube e fai clic su «Collega».
- Quando il badge indica «Collegato», i messaggi dei tuoi spettatori compaiono nella chat della stanza e il conduttore risponde.
- Twitch: i messaggi che iniziano con «!» sono considerati comandi per bot e vengono saltati.
- YouTube: la live deve essere già in onda, con la chat attiva. Incolla il link del video live, non quello del canale. I nuovi messaggi arrivano ogni 8 secondi circa.
- Le altre piattaforme (Bilibili, Douyin, TikTok e così via) non sono integrate. Usa l’interfaccia HTTP qui sotto.
Per tutte le piattaforme che non leggiamo direttamente: esegui un programma che legge la chat della tua piattaforma e ci inoltra ogni messaggio con una richiesta HTTP. Il conduttore lo tratta come qualsiasi altro messaggio della chat.
Richiesta
https://dangcingai.com/api/live/demo/ingest
| Header | Authorization: Bearer YOUR_TOKENContent-Type: application/json |
|---|---|
user | Il nome del mittente, mostrato nella chat e letto ad alta voce dal conduttore. Massimo 16 caratteri. |
text | Il messaggio. Massimo 50 caratteri; la parte in eccesso viene tagliata. |
Per la tua live, l’indirizzo e il token si trovano nella stanza della tua live, in «Ricevi chat». Il token viene mostrato una sola volta, quando lo generi; generarne uno nuovo annulla quello vecchio.
Provalo sulla demo
Ottieni un token personale, esegui uno degli esempi mentre la demo è in diretta e guarda il tuo messaggio comparire nella chat della demo e ricevere risposta.
Accedi per ottenere un token demo Apri la demo
Sulla demo cambiano due cose: i messaggi compaiono sempre con il nome del tuo account (il campo user viene ignorato) e ogni account può inviare un messaggio ogni 5 secondi.
curl -X POST 'https://dangcingai.com/api/live/demo/ingest' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"user":"Tom","text":"hello"}'
import requests
URL = "https://dangcingai.com/api/live/demo/ingest"
TOKEN = "YOUR_TOKEN"
def send(user: str, text: str) -> None:
resp = requests.post(URL, json={"user": user, "text": text},
headers={"Authorization": "Bearer " + TOKEN}, timeout=10)
print(resp.status_code, resp.text)
send("Tom", "hello")
$body = @{ user = "Tom"; text = "hello" } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "https://dangcingai.com/api/live/demo/ingest" `
-Headers @{ Authorization = "Bearer YOUR_TOKEN" } `
-ContentType "application/json; charset=utf-8" -Body $body
Risposte
200 | {"id": 123} | Accettato. Il conduttore risponderà quando arriva il suo turno. |
|---|---|---|
400 | bad_text | Il testo è vuoto o non è una stringa. |
401 | unauthorized | Il token manca o è errato, oppure è stato sostituito da uno più recente. |
409 | offline | La live non è in onda in questo momento. |
429 | too_fast | Troppi messaggi. Questo è stato scartato; non riprovare a inviarlo, invia il prossimo più tardi. |
503 | server_error | Un problema da parte nostra. Riprova tra un attimo. |
Limiti
- Il conduttore risponde a un messaggio alla volta e una risposta richiede diversi secondi. Per una live vengono accettati al massimo 20 messaggi al minuto, contando tutte le fonti insieme.
- Quando ci sono già 3 messaggi in attesa, quelli nuovi vengono scartati invece di essere messi in coda, perché nessuno vuole una risposta a un messaggio di un minuto fa. In una chat affollata, scegli i messaggi a cui vale la pena rispondere prima di inoltrarli.
- I messaggi con parole bloccate non vengono letti ad alta voce e non compaiono nella chat.
OBS o il lettore non mostra nulla
Controlla che la live sia in onda, poi copia di nuovo l’indirizzo: HOST e password cambiano a ogni sessione. Se RTMP non si collega, prova SRT e assicurati che la tua rete consenta UDP in uscita sulla porta 8890.
L’immagine va a scatti o l’audio salta
Usa l’indirizzo SRT e una connessione via cavo. Le macchine di streaming si trovano in Cina, quindi dagli altri continenti RTMP spesso non riesce a tenere il passo, mentre SRT recupera i dati persi entro la latenza impostata nell’indirizzo.
Il conduttore non risponde a un messaggio
Il conduttore risponde a un messaggio alla volta, quindi in una chat affollata la maggior parte dei messaggi viene saltata. Un messaggio viene saltato anche se contiene parole bloccate o se la richiesta ha ricevuto una risposta 429.
Quanto è in ritardo lo stream?
Il conduttore inizia a parlare pochi secondi dopo l’arrivo di un messaggio. Ricevere e ritrasmettere lo stream aggiunge qualche altro secondo, e la piattaforma aggiunge il proprio ritardo, quindi su una piattaforma gli spettatori sentono la risposta sensibilmente più tardi rispetto alla stanza su questo sito.