Integrazione vMix

Invia sottotitoli dal vivo a vMix per produzioni broadcast.

Panoramica

Invia sottotitoli in tempo reale a vMix per produzioni broadcast. Maestra viene eseguito sullo stesso computer di vMix e invia i tuoi sottotitoli dal vivo in un input titolo di vMix.

Prima di iniziare

Usa Google Chrome e mantienilo aggiornato all'ultima versione.
Assicurati che vMix sia in esecuzione e che il Web Controller di vMix sia abilitato.
Apri Maestra nello stesso browser, sulla stessa macchina di vMix.

Come configurare

Devi eseguire vMix sullo stesso computer su cui e in esecuzione Maestra Live.
Scarica questo modello di titolo che mostrera i sottotitoli in vMix. Importa questo modello di titolo in vMix andando su Aggiungi input > Titolo/XAML. In alto a destra della finestra Selezione input, fai clic su Sfoglia... e seleziona il file del modello di titolo scaricato. Fai clic su OK.
In vMix, vai su Impostazioni > Controller web e seleziona la casella per abilitare il controller web.
Imposta la porta o accetta quella predefinita.
Copia l'"Indirizzo sito web vMix" e incollalo in Maestra.
Facoltativamente, scarica la Maestra Companion App per un'esperienza piu fluida. Una volta installata e avviata, abilitala nelle impostazioni del canale vMix, aggiorna la pagina e goditi i sottotitoli in vMix.

Risoluzione dei problemi

Se i sottotitoli non raggiungono vMix dalla tua sessione in tempo reale di Maestra, segui questa lista di controllo in ordine. Ogni passaggio esclude una causa comune, dalle impostazioni del Web Controller e dalle autorizzazioni di rete di Chrome ai firewall, alle porte e al modello dei sottotitoli di vMix. Fermati non appena i sottotitoli iniziano ad aggiornarsi sullo schermo.

Lista di controllo

Verifica le nozioni di base

Esegui il Web Controller di vMix sulla stessa macchina del browser che usa Maestra.
Assicurati che il canale punti all'URL vMix corretto (predefinito http://localhost:8088) e che il titolo dei sottotitoli o il GUID del modello corrisponda.

Esamina le opzioni di sicurezza del Web Controller

Mantieni selezionata l'opzione Allow software on this computer access without login.
Lascia deselezionata l'opzione Enable enhanced security on Web and TCP API.
Lascia deselezionata l'opzione Restrict access to LAN only.

Abilita l'accesso alla rete locale in Chrome

Visita chrome://settings/content/all, poi cerca e seleziona live.maestra.ai (oppure usa il lucchetto, poi Impostazioni sito).
Imposta Accesso alla rete locale su Consenti, ricarica Maestra e riprova.

Verifica la raggiungibilità della rete

Su quella macchina, apri l'URL del Web Controller (ad esempio http://localhost:8088) in un qualsiasi browser.
Se non si carica o è lento, risolvi prima quel problema: avvia vMix, correggi la porta e sblocca i firewall.

Prova una porta diversa

Se 8088 continua a non funzionare, cambia il Web Controller di vMix con una porta alta non utilizzata (ad esempio 2025), aggiorna l'URL in Maestra e riprova.
Questo spesso aggira i filtri di sicurezza aziendali o i listener obsoleti legati alle porte comuni.

Escludi blocchi aziendali o VPN

Disconnetti temporaneamente VPN, firewall endpoint o antivirus che potrebbero impedire alle pagine HTTPS di raggiungere http://localhost.
Se i sottotitoli iniziano a funzionare, inserisci vMix e il browser nella whitelist, poi riattiva gli strumenti di sicurezza.

Convalida il modello di vMix

In Title Designer, assicurati che il campo WebCaptionerCaptions esista e che il GUID corrisponda alle impostazioni di Maestra.
Modifica manualmente il campo in vMix per confermare che si aggiorni sullo schermo.

Ispeziona il browser

Apri DevTools, poi la scheda Network, abilita il canale e osserva la richiesta SetText.
Nota se il browser segnala contenuti misti (Mixed Content), Private Network Access o CORS, oppure se la richiesta non parte mai.

Risolvi gli avvisi di contenuti misti o di rete privata

Chrome, Edge o Brave: disabilita chrome://flags/#block-insecure-private-network-requests, poi riavvia.
Safari: attiva Sviluppo, poi Disattiva le restrizioni cross-origin durante i test.
Firefox: imposta network.websocket.allowInsecureFromHTTPS su true e assicurati che la modalità solo HTTPS sia disattivata.

Monitora i risultati

Tieni DevTools aperto mentre i sottotitoli sono in esecuzione. Se le richieste sembrano andate a buon fine ma il testo non si aggiorna, cattura screenshot della voce Network e dell'anteprima di vMix.
Raccogli il timestamp, la versione del browser, il sistema operativo ed eventuali errori della console prima di segnalare il problema all'assistenza.

Hai ancora problemi?

Se i sottotitoli continuano a non aggiornarsi dopo questa lista di controllo, apri il widget di assistenza nell'app e fai clic su Crea un ticket. Includi il timestamp, la versione del browser, il sistema operativo, la versione di vMix ed eventuali errori della console.