Scegli una modalità sorgente Twitch
| Modalità | Ideale per | Differenza importante |
|---|---|---|
| Standard | Acquisizione di base della chat pubblica da una pagina chat Twitch normale o separata. | Legge ciò che la pagina espone. È semplice, ma non fornisce l'insieme completo degli eventi EventSub. |
| WebSocket / EventSub | Follow, abbonamenti, Bits, ricompense, raid, stato della diretta, Hype Train, sincronizzazione della moderazione, invio chat e dettagli del canale. | Richiede OAuth Twitch. Gli eventi vengono attivati solo se account connesso, ruolo nel canale, idoneità del canale e ambito concesso lo consentono. |
Configurazione dell'app desktop
- Seleziona Aggiungi sorgente → Twitch.
- Inserisci il nome di accesso del canale Twitch usato nel suo URL. Per
twitch.tv/examplechannel, inserisciexamplechannel. - Lascia WebSocket selezionato per la sorgente EventSub più completa. Attualmente Twitch usa questa modalità come predefinita nell'app.
- Seleziona Attiva sorgente (Activate source), poi Accedi a Twitch.
- Autorizza i permessi richiesti e mantieni aperta la finestra della sorgente Twitch.
Configurazione EventSub nell'estensione browser
- Installa e abilita l'estensione Social Stream Ninja attuale.
- Apri Pagina sorgente Twitch EventSub.
- Sostituisci
examplechannelnell'URL con il nome di accesso del canale da monitorare. - Seleziona Accedi a Twitch e approva l'accesso richiesto.
- Mantieni aperta quella pagina. Verifica che i campi User e Channel siano corretti prima di provare gli avvisi.
https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN
Per l'acquisizione Standard di base, apri invece la normale pagina chat Twitch o la chat separata e mantienila visibile.
Cosa richiede Twitch
Social Stream richiede un token utente con i permessi necessari ai controlli e alle sottoscrizioni supportati. Concedere un ambito non rende un account broadcaster o moderatore; Twitch verifica comunque il ruolo dell'account nel canale selezionato.
| Gruppo di autorizzazioni | Usato per |
|---|---|
| Chat | Leggere la chat, inviare messaggi ed elencare gli utenti in chat. |
| Follower e abbonati | Eventi follow, eventi degli abbonati, abbonamenti regalo e messaggi di riabbonamento. |
| Bits, ricompense e Hype Train | Cheer, riscatti personalizzati dei punti canale e stato degli Hype Train. |
| Moderazione | Eliminazione dei messaggi, ban/timeout e sincronizzazione dei blocchi quando l'account può moderare il canale. |
| Gestione del canale | Leggere/aggiornare titolo e categoria, leggere/gestire annunci e mostrare metriche del canale. |
Consulta il riferimento ufficiale Twitch sugli ambiti e tipi di sottoscrizione EventSub.
Eventi gestiti dalla sorgente attuale
- Follow:
new_follower. - Abbonamenti:
new_subscriber,resub, esubscription_gift. - Bits:
cheercon un valore di donazione. - Punti canale:
reward. - Raid:
raid. - Stato della diretta e degli annunci:
stream_online,stream_offline, ead_break. - Hype Train:
hype_trainaggiornamenti di inizio, avanzamento e fine. - Moderazione: aggiornamenti su ban ed eliminazione dei messaggi, quando consentiti.
Gli eventi degli abbonati Twitch richiedono un canale Affiliate/Partner idoneo e l'accesso del broadcaster. Le sottoscrizioni follow e moderazione richiedono che l'utente connesso sia il broadcaster o un moderatore autorizzato, a seconda dell'evento.
Per i nomi degli avvisi a valle e i campi dei payload, usa la guida alla compatibilità di eventi e avvisi e Riferimento degli eventi.
Primi controlli quando manca un evento
- Verifica che la pagina sorgente indichi i valori corretti di Utente (User) e Canale.
- Mantieni aperta la pagina/finestra della sorgente e verifica che la connessione chat sia attiva.
- Se la chat funziona ma follow/abbonamenti/ricompense no, esci e autorizza di nuovo per concedere gli ambiti attuali.
- Verifica che l'account connesso sia il broadcaster o un moderatore autorizzato per quel canale.
- Verifica che dock e overlay degli avvisi usino lo stesso ID di sessione Social Stream.
- Usa il messaggio fittizio di prova del popup o l'anteprima Multi Alerts per distinguere i problemi di acquisizione da quelli dell'overlay.
EventSub può consegnare una notifica più di una volta. Twitch documenta la consegna almeno una volta. Social Stream include una protezione dai duplicati, ma i consumer API personalizzati dovrebbero comunque deduplicare in base all'identità dell'evento/messaggio quando possibile. Consulta la documentazione ufficiale panoramica EventSub.