Guida al dock di controllo OBS - Social Stream Ninja

Configurazione rapida

In Social Stream Ninja, apri Impostazioni globali e strumenti → Meccanismi.
Apri OBS Control Dock and copy its link. Keep Social Stream Ninja active during the stream.
The copied link includes your session, password, and connection settings.
In OBS, apri Dock → Dock del browser personalizzati.
Assegna al dock il nome Controlli Social Stream and paste the copied link. For a session without a password or server settings, the URL is:

https://socialstream.ninja/obs-control-dock.html?session=YOUR_SESSION_ID

Seleziona Applica, chiudi la finestra delle impostazioni e posiziona il nuovo dock dove vuoi in OBS.
Conferma che il dock indichi Connesso. Se l'URL non includeva una sessione, inseriscila nel dock e seleziona Salva e connetti.

Apri il dock di controllo

Quali impostazioni server sono richieste?

The generated control link follows Social Stream's connection settings. Normal links use P2P. When Il dock invia i comandi all'estensione tramite server is enabled, controls use that server connection.

For a manually configured API connection, add &server (oppure &server=wss://YOUR_SERVER) and enable controllo API remoto dell'estensione.

OBS's Impostazioni server WebSocket non sono correlate e possono restare disattivate.

Uso con i titoli di coda di fine diretta

Prima della diretta, imposta nei titoli di coda Modalità di attivazione a Raccolta in background. Consente all'app di raccogliere partecipanti alla chat, membri e donatori mentre la sorgente browser dei titoli di coda è chiusa.
Aggiungi l'URL generato dei titoli di coda alla scena finale OBS usando lo stesso ID sessione.
Alla fine della diretta, passa prima alla scena finale affinché la sorgente browser dei titoli di coda sia caricata e connessa.
Seleziona Avvia ringraziamenti (Start Credits) nel dock di controllo OBS.

Carica prima di Avvia: la raccolta in background può funzionare mentre la pagina dei titoli di coda è chiusa, ma Avvia, Anteprima e Test richiedono una sorgente browser dei titoli di coda connessa per mostrare qualcosa.

Consulta Guida ai ringraziamenti scorrevoli per modalità di raccolta, filtri e risoluzione dei problemi dei nomi mancanti.

Cosa fa ogni pulsante dei titoli di coda

Pulsante	Risultato
Avvia ringraziamenti (Start Credits)	Esegue l'elenco reale raccolto.
Anteprima	Esegue l'elenco reale senza consumare le voci raccolte dalla pagina.
Prova titoli di coda	Mostra esempi integrati di partecipanti, membri e donatori. Non dimostra che siano stati raccolti nomi reali.
Azzera titoli di coda salvati	Svuota la raccolta in background salvata per la sessione Social Stream attiva.

Prodotti e link di supporto (Products & support links)

In Social Stream, apri Monetizzazione, salva e abilita i prodotti, poi scegli Apri dock di controllo OBS. Copia quell'URL di controllo privato nei Dock del browser personalizzati di OBS. Per un dock dedicato solo ai prodotti, usa obs-control-dock.html?session=YOUR_SESSION_ID&commerce.

Keep Social Stream on and use the generated Product Controls link. Add the separate monetization overlay URL as an OBS Browser Source for viewers. The control dock is for you; never share its session URL with viewers.

Controlli prodotti OBS con selettore dei prodotti salvati, durata, Mostra, Avanti, Nascondi prodotti, Riprendi programmazione e stato del prodotto selezionato

Mostra: seleziona un prodotto salvato e fissalo. Avanti: passa al prodotto successivo a quello corrente.
Nascondi prodotti: nasconde le schede promozionali; gli avvisi di attività continuano. Riprendi programmazione: torna all'impostazione salvata del primo prodotto o della rotazione.
Durata: Mostra, Avanti e Nascondi tornano alla programmazione salvata dopo questo numero di secondi. Usa 0 per mantenere la sostituzione fino a una modifica.
Stato: si aggiorna ogni cinque secondi mentre questa sezione è aperta. Segnala la selezione di Social Stream, non se una scena OBS sia visibile. Le connessioni perse o non confermate disabilitano i pulsanti dei prodotti finché lo stato non torna disponibile.

Dock, popup, Stream Deck ed Event Flow condividono gli stessi controlli. Modifica e salva il catalogo in Social Stream. Vedi Controlli dei prodotti per configurazione e automazione.

Altri controlli e relative pagine richieste

Chat in primo piano: mantieni il normale Streaming Chat Dock e l'overlay in primo piano connessi alla stessa sessione.
Timer: mantieni la pagina Timer connessa alla stessa sessione se deve visualizzare il timer.
Lista d'attesa e giveaway: configura prima la lista d'attesa in Social Stream; Azzera elimina le voci correnti.

Il dock si riconnette automaticamente se cade la connessione API. Uno stato verde Connesso conferma solo la connessione di controllo; la pagina di destinazione deve comunque essere aperta quando un comando visualizza qualcosa.

Esempi API diretti

Gli stessi pulsanti possono essere automatizzati con richieste HTTP GET:

https://io.socialstream.ninja/SESSION_ID/creditsStart
https://io.socialstream.ninja/SESSION_ID/creditsPreview
https://io.socialstream.ninja/SESSION_ID/creditsTest
https://io.socialstream.ninja/SESSION_ID/creditsReset

Sostituisci SESSION_ID con la sessione Social Stream attiva. Vedi Comandi e API oppure il sandbox API completa per altre azioni.

Risoluzione dei problemi

Serve una sessione: usa l'ID sessione esatto di Social Stream, senza la parola session=.
Disconnesso: confirm Social Stream is active and reopen the generated control link after changing connection settings.
I titoli di coda dicono che nessuna sorgente ha accettato il comando: mostra la scena finale, attendi il caricamento della sua sorgente browser e riprova.
Test funziona ma Avvia è vuoto: Test usa nomi integrati. Seleziona Raccolta in background prima della diretta e conferma che le normali sorgenti chat stiano acquisendo.
Il pulsante Chat in primo piano non ha effetti visibili: conferma che Streaming Chat Dock e l'overlay in primo piano usino la stessa sessione e siano caricati.