OBS Studio
Inclusa in Macro DeckCambia scena, controlla stream, registrazione e audio e reagisci a ciò che succede in OBS Studio.
La finestra Connetti OBS Studio con nome configurazione, host, porta e password
- Cambia scene, profili e collezioni di scene
- Avvia e interrompi streaming, registrazione, buffer di replay e fotocamera virtuale
- Silenzia input, imposta volumi e alterna sorgenti e filtri
- Variabili in tempo reale per scene, timecode, FPS e frame persi
- Collega più istanze di OBS contemporaneamente
L'integrazione OBS Studio collega Macro Deck a OBS tramite il server WebSocket integrato in OBS (obs-websocket 5). Una volta connessa, i tuoi pulsanti possono controllare quasi tutto ciò che fai in OBS durante uno stream e OBS riporta cosa cambia, così il deck mostra sempre lo stato attuale.
Cosa puoi fare
- Cambia la scena del programma, la scena di anteprima della modalità studio, il profilo o la collezione di scene.
- Avvia, interrompi o alterna streaming, registrazione, buffer di replay e fotocamera virtuale, salva un replay, metti in pausa una registrazione, dividi il file di registrazione o aggiungi un marcatore di capitolo.
- Mostra o nascondi una sorgente in una scena, attiva o disattiva un filtro, silenzia un input o cambiane il volume in percentuale o in dB.
- Modifica un'impostazione di una sorgente, per esempio il testo di una sorgente di testo, il file di una sorgente immagine o multimediale o l'URL di una sorgente browser.
- Avvia e interrompi qualsiasi output di OBS per nome, compresi gli output aggiunti dai plugin.
Alcuni esempi di configurazione:
- Un pulsante Torno subito che passa alla tua scena di pausa e silenzia il microfono.
- Un pulsante Registra che alterna la registrazione e mostra se OBS sta registrando, è in pausa o è fermo.
- Uno slider collegato alla variabile
obs_<input>_volumedell'input musicale, così spostando lo slider cambia il volume in OBS. - Un flusso che si attiva quando OBS segnala Streaming avviato e ti invia una notifica.
Come funziona
Macro Deck ascolta gli eventi che OBS invia, quindi variabili come la scena attuale, lo stato di silenziamento e lo stato dei filtri si aggiornano in una frazione di secondo dopo che li cambi in OBS. I pulsanti di alternanza si illuminano finché il loro stato è attivo, anche quando lo cambi direttamente in OBS. Statistiche come FPS, utilizzo della CPU, bitrate e frame persi vengono lette ogni uno o due secondi.
Oltre alle variabili fisse, il selettore di variabili elenca ogni input, scena, elemento di scena e filtro dell'OBS connesso, con volume, stato di silenziamento, visibilità o stato di attivazione. I trigger reagiscono a cambi di scena, cambi di registrazione e streaming, replay e screenshot salvati, input che diventano attivi ed eventi personalizzati trasmessi dai tuoi script di OBS.
Puoi aggiungere più di una configurazione, per esempio una per il PC per lo streaming e una per il PC da gioco. Ogni configurazione riceve il proprio insieme di variabili e ogni azione ha un campo Configurazione per scegliere quale OBS controlla. Quando OBS si chiude o la rete cade, Macro Deck continua a provare a riconnettersi e attiva i trigger Disconnesso e Connesso.
Cosa ti serve
- Macro Deck 3 su Windows, macOS o Linux
- OBS Studio 28 o successivo (include obs-websocket 5)
- Il server WebSocket attivato in OBS in Tools > WebSocket Server Settings
- Per avviare e interrompere gli output per nome serve obs-websocket 5.7 o successivo
Configurala
Passaggio 1: Attiva il server WebSocket in OBS
In OBS, apri Tools > WebSocket Server Settings e spunta Enable WebSocket server. Annota la Server Port (predefinita
4455). Se Enable Authentication è spuntato, fai clic su Show Connect Info per vedere la password.Passaggio 2: Apri OBS Studio in Macro Deck
In Macro Deck, fai clic su Integrazioni nella barra laterale e poi su OBS Studio. Nella scheda Panoramica, fai clic su Aggiungi configurazione nella sezione Configurazione. Attivando l'interruttore in alto a destra si apre la stessa finestra, e l'integrazione si attiva al termine della configurazione.
Passaggio 3: Inserisci i dati di connessione
Compila la finestra Connetti OBS Studio:
- Nome configurazione: un nome a tua scelta, per esempio
Streaming PC. - Host:
127.0.0.1quando OBS gira sullo stesso computer, altrimenti l'indirizzo IP del computer su cui gira OBS. - Porta: la porta del server indicata in OBS,
4455per impostazione predefinita. - Password: la password indicata in OBS. Lasciala vuota se l'autenticazione è disattivata.
Fai clic su Continua. Macro Deck prova la connessione prima di salvare la configurazione.
- Nome configurazione: un nome a tua scelta, per esempio
Passaggio 4: Aggiungi un'azione OBS a un pulsante
Nella pagina Deck, fai clic sul pulsante che vuoi usare. Il deck deve essere sbloccato: se il pulsante in alto a destra indica Blocca, è sbloccato. L'editor si apre con Pressione Breve selezionata. Fai clic su + Aggiungi azione, seleziona OBS Studio a sinistra nella finestra Aggiungi azione e scegli un'azione come Imposta scena. Seleziona la Configurazione e la Scena, poi fai clic su Salva.
Passaggio 5: Premi il pulsante
Premi il pulsante sul telefono, sul tablet o nel client web. OBS passa alla scena che hai scelto. Se non succede nulla, verifica che OBS sia in esecuzione e che la configurazione mostri Connesso nella pagina OBS Studio in Integrazioni.
Azioni35
Assegnale a un pulsante o eseguile da un flusso.
- Imposta scena
- Cambia la scena attiva del programma.
- Imposta scena di anteprima
- Cambia la scena di anteprima della modalità studio.
- Imposta profilo
- Passa OBS a un altro profilo.
- Imposta collezione scene
- Passa OBS a un'altra collezione di scene.
- Avvia registrazione
- Avvia la registrazione.
- Interrompi registrazione
- Interrompe la registrazione.
- Alterna registrazione
- Avvia o interrompe la registrazione e mostra se OBS sta registrando, è in pausa o è fermo.
- Pausa/Riprendi registrazione
- Mette in pausa o riprende la registrazione in corso.
- Avvia streaming
- Avvia lo stream.
- Interrompi streaming
- Interrompe lo stream.
- Alterna streaming
- Avvia o interrompe lo stream.
- Avvia fotocamera virtuale
- Avvia la fotocamera virtuale.
- Interrompi fotocamera virtuale
- Interrompe la fotocamera virtuale.
- Alterna fotocamera virtuale
- Avvia o interrompe la fotocamera virtuale.
- Avvia buffer di replay
- Avvia il buffer di replay.
- Interrompi buffer di replay
- Interrompe il buffer di replay.
- Alterna buffer di replay
- Avvia o interrompe il buffer di replay.
- Salva buffer di replay
- Salva su disco il buffer di replay attuale.
- Dividi file di registrazione
- Avvia un nuovo file di registrazione mentre la registrazione continua.
- Crea capitolo di registrazione
- Aggiunge un marcatore di capitolo al file in registrazione (solo formato Hybrid MP4).
- Imposta cartella di registrazione
- Imposta la cartella in cui OBS scrive le nuove registrazioni.
- Avvia output
- Avvia un output di OBS per nome, compresi gli output aggiunti dai plugin.
- Interrompi output
- Interrompe un output di OBS per nome, compresi gli output aggiunti dai plugin.
- Attiva/disattiva output
- Avvia o interrompe un output di OBS per nome, compresi gli output aggiunti dai plugin.
- Leggi stato output
- Legge in una variabile se un output di OBS è attivo.
- Imposta visibilità sorgente
- Mostra, nasconde o alterna una sorgente in una scena.
- Escludi audio input
- Silenzia, riattiva o alterna un input audio.
- Imposta volume input
- Imposta, aumenta o diminuisce il volume di un input audio in percentuale o in dB.
- Imposta filtro sorgente
- Attiva, disattiva o alterna un filtro su una sorgente.
- Modifica impostazione input
- Modifica un'impostazione di una sorgente, per esempio il testo di una sorgente di testo o l'URL di una sorgente browser.
- Leggi volume input
- Legge in una variabile la percentuale di volume di un input audio.
- Leggi stato filtro
- Legge in una variabile se un filtro della sorgente è attivo.
- Ottieni stato di silenziamento
- Legge in una variabile se un input audio è silenziato.
- Ottieni visibilità sorgente
- Legge in una variabile se una sorgente è visibile in una scena.
- Alterna modalità studio
- Attiva o disattiva la modalità studio.
Trigger24
Un pulsante o un flusso può reagire a questi eventi.
- Scena modificata
- La scena del programma (in diretta) è cambiata. Facoltativamente solo per una scena.
- Scena di anteprima modificata
- La scena di anteprima della modalità studio è cambiata.
- Registrazione avviata
- OBS ha avviato la registrazione.
- Registrazione interrotta
- OBS ha interrotto la registrazione.
- Registrazione in pausa
- La registrazione è stata messa in pausa.
- Registrazione ripresa
- La registrazione è stata ripresa.
- File di registrazione cambiato
- La registrazione è iniziata, è passata a un nuovo file o si è interrotta, con il percorso del file.
- Streaming avviato
- OBS ha avviato lo streaming.
- Streaming interrotto
- OBS ha interrotto lo streaming.
- Buffer di replay avviato
- Il buffer di replay è stato avviato.
- Buffer di replay interrotto
- Il buffer di replay è stato interrotto.
- Buffer di replay salvato
- Una clip di replay è stata scritta su disco, con il percorso del file.
- Screenshot salvato
- OBS ha salvato uno screenshot su disco, con il percorso del file.
- Fotocamera virtuale avviata
- La fotocamera virtuale è stata avviata.
- Fotocamera virtuale interrotta
- La fotocamera virtuale è stata interrotta.
- Modalità studio modificata
- La modalità studio è stata attivata o disattivata.
- Esclusione audio input modificata
- Un input audio è stato silenziato o riattivato. Facoltativamente solo per un input.
- Input diventato attivo
- Un input ha iniziato a essere mostrato nell'uscita del programma, per esempio una webcam che va in diretta.
- Input diventato inattivo
- Un input non viene più mostrato nell'uscita del programma.
- Input visibile
- Un input ha iniziato a essere mostrato nell'uscita del programma o dell'anteprima.
- Input non più visibile
- Un input non viene più mostrato nell'uscita del programma o dell'anteprima.
- Evento personalizzato
- Uno script o un plugin di OBS ha trasmesso un evento personalizzato. Facoltativamente solo per un nome di evento.
- Connesso
- Macro Deck si è connesso a OBS e OBS ha terminato il caricamento.
- Disconnesso
- La connessione a OBS è stata persa.
Variabili14
Mostra questi valori su pulsanti e widget o usali nelle condizioni.
obs_<configuration>_is_connected- Indica se Macro Deck è connesso a questo OBS.
obs_<configuration>_current_scene- La scena attiva del programma.
obs_<configuration>_preview_scene- La scena di anteprima della modalità studio.
obs_<configuration>_current_profile- Il profilo attivo.
obs_<configuration>_current_scene_collection- La collezione di scene attiva.
obs_<configuration>_is_recording,obs_<configuration>_recording_paused,obs_<configuration>_recording_timecode- Indica se OBS sta registrando o è in pausa, e da quanto dura la registrazione.
obs_<configuration>_is_streaming,obs_<configuration>_streaming_timecode- Indica se OBS è in streaming e da quanto tempo.
obs_<configuration>_virtual_camera_active,obs_<configuration>_replay_buffer_active,obs_<configuration>_studio_mode_active- Indica se la fotocamera virtuale, il buffer di replay e la modalità studio sono attivi.
obs_<configuration>_fps,obs_<configuration>_max_fps,obs_<configuration>_cpu_usage- Dati sulle prestazioni riportati da OBS.
obs_<configuration>_streaming_bitrate,obs_<configuration>_recording_bitrate- I bitrate attuali degli output in kbps.
obs_<configuration>_dropped_frames,obs_<configuration>_dropped_frames_percent,obs_<configuration>_skipped_frames,obs_<configuration>_skipped_frames_percent- I frame persi dello stream e i frame saltati dall'encoder, come numero e in percentuale.
obs_<configuration>_last_recording_file,obs_<configuration>_last_screenshot- Il percorso dell'ultimo file di registrazione e dell'ultimo screenshot.
obs_<input>_volume,obs_<input>_mutede altre- Per ogni input che scegli: volume in dB (scrivibile, quindi uno slider può impostarlo), silenziamento, attivo, visibile, tracce audio (da
obs_<input>_track_1a_6), tipo di monitoraggio, offset di sincronizzazione e le sue impostazioni. Il selettore propone questi nomi e puoi cambiarli. obs_<scene>_<source>_visible,obs_<source>_<filter>_enabled- Indica se una sorgente è visibile in una scena e se un filtro è attivo. Il selettore propone questi nomi e puoi cambiarli.
Domande frequenti
Funziona quando OBS gira su un altro computer?
Sì. Inserisci come Host l'indirizzo IP del computer su cui gira OBS e consenti la porta (4455 per impostazione predefinita) nel firewall di quel computer. I percorsi in azioni come Imposta cartella di registrazione o Modifica impostazione input sono percorsi del computer su cui gira OBS.
Posso controllare più di un OBS?
Sì. Aggiungi una configurazione per ogni istanza di OBS con Aggiungi configurazione. Ognuna ha le proprie variabili e ogni azione ha un campo Configurazione per scegliere l'OBS che controlla.
Cosa succede quando OBS si chiude o la connessione cade?
Macro Deck continua a provare a riconnettersi in background e si connette di nuovo appena OBS torna disponibile. Fino ad allora le azioni non riescono con OBS non è connesso. e si attivano i trigger Disconnesso e Connesso, così un flusso può reagire.
Perché un'azione non riesce?
L'azione mostra il motivo, per esempio che una scena o una sorgente non esiste più, che OBS sta ancora caricando una collezione di scene o che OBS non sta registrando (per Dividi file di registrazione e Crea capitolo di registrazione). Se hai rinominato qualcosa in OBS, selezionalo di nuovo nell'azione.
Dove viene salvata la password del WebSocket?
Macro Deck salva la password in forma crittografata sul computer su cui gira Macro Deck e la usa solo per connettersi a OBS.
Altro in Streaming
Meld Studio
Inclusa in Macro DeckCambia e prepara scene, controlla livelli, effetti e tracce audio e vai in diretta in Meld Studio.
Streamlabs Desktop
Inclusa in Macro DeckCambia scena, controlla stream, registrazione e sorgenti audio in Streamlabs Desktop.
Streamer.bot
Inclusa in Macro DeckEsegui azioni di Streamer.bot, invia messaggi in chat e reagisci a ogni evento segnalato da Streamer.bot.
Twitch
Inclusa in Macro DeckMostra la chat e le statistiche del tuo stream Twitch, modera, avvia sondaggi e pubblicità e reagisci a follow, abbonamenti e raid.
YouTube
Inclusa in Macro DeckMostra la chat dal vivo e le statistiche del tuo stream YouTube, cambia titolo e tag e reagisci a Super Chat e membri.