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

  1. Devi eseguire vMix sullo stesso computer su cui e in esecuzione Maestra Live.
  2. 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.
  3. In vMix, vai su Impostazioni > Controller web e seleziona la casella per abilitare il controller web.
  4. Imposta la porta o accetta quella predefinita.
  5. Copia l'"Indirizzo sito web vMix" e incollalo in Maestra.
  6. 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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.
  10. 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.