vMix-integratie

Stuur live ondertitels naar vMix voor broadcast-producties.

Overzicht

Stuur realtime ondertitels naar vMix voor broadcast-producties. Maestra draait op dezelfde computer als vMix en stuurt je live ondertitels naar een vMix-titelinvoer.

Voordat je begint

Gebruik Google Chrome en houd het bijgewerkt naar de nieuwste versie.
Zorg dat vMix actief is en de vMix Web Controller is ingeschakeld.
Open Maestra in dezelfde browser, op dezelfde machine als vMix.

Instellen

Je moet vMix op dezelfde computer draaien als waarop Maestra Live actief is.
Download dit titelsjabloon dat ondertitels in vMix weergeeft. Importeer dit titelsjabloon in vMix via Invoer toevoegen > Titel/XAML. Klik rechtsboven in het venster Invoer selecteren op Bladeren... en selecteer het gedownloade titelsjabloonbestand. Klik op OK.
Ga in vMix naar Instellingen > Webcontroller en vink het vakje aan om de webcontroller in te schakelen.
Stel de poort in of accepteer de standaardwaarde.
Kopieer het 'vMix Website Adres' en plak het in Maestra.
Download optioneel de Maestra Companion App voor een soepelere ervaring. Zodra deze is geinstalleerd en actief is, schakel je hem in via de vMix-kanaalinstellingen, vernieuw je de pagina en geniet je van ondertitels in vMix.

Problemen oplossen

Als er geen ondertitels bij vMix aankomen vanuit je Maestra realtime-sessie, werk dan deze checklist in volgorde af. Elke stap sluit een veelvoorkomende oorzaak uit, van Web Controller-instellingen en Chrome-netwerkmachtigingen tot firewalls, poorten en de vMix-ondertitelsjabloon. Stop zodra de ondertitels op het scherm worden bijgewerkt.

Checklist

Bevestig de basis

Draai de vMix Web Controller op dezelfde machine als de browser waarin je Maestra gebruikt.
Zorg dat het kanaal naar de juiste vMix-URL verwijst (standaard http://localhost:8088) en dat de ondertiteltitel of template-GUID overeenkomt.

Controleer de beveiligingsopties van de Web Controller

Houd Allow software on this computer access without login aangevinkt.
Laat Enable enhanced security on Web and TCP API uitgevinkt.
Laat Restrict access to LAN only uitgevinkt.

Schakel toegang tot het lokale netwerk in Chrome in

Ga naar chrome://settings/content/all, zoek en selecteer vervolgens live.maestra.ai (of gebruik het hangslot en daarna Site-instellingen).
Stel Local network access in op Allow, laad Maestra opnieuw en probeer het nogmaals.

Controleer de netwerkbereikbaarheid

Open op die machine de Web Controller-URL (bijvoorbeeld http://localhost:8088) in een willekeurige browser.
Als deze niet laadt of traag is, los dat dan eerst op: start vMix, corrigeer de poort en deblokkeer firewalls.

Probeer een andere poort

Als 8088 blijft mislukken, wijzig de vMix Web Controller dan naar een ongebruikte hoge poort (bijvoorbeeld 2025), werk de URL in Maestra bij en test opnieuw.
Dit omzeilt vaak bedrijfsbeveiligingsfilters of verouderde listeners die aan veelgebruikte poorten zijn gekoppeld.

Sluit blokkades door bedrijfsnetwerk of VPN uit

Verbreek tijdelijk VPN's, endpointfirewalls of antivirussoftware die HTTPS-pagina's mogelijk verbieden om http://localhost te bereiken.
Als de ondertitels gaan werken, zet vMix en de browser dan op de witte lijst en schakel de beveiligingstools weer in.

Valideer het vMix-sjabloon

Zorg in Title Designer dat het veld WebCaptionerCaptions bestaat en dat de GUID overeenkomt met de Maestra-instellingen.
Bewerk het veld handmatig in vMix om te bevestigen dat het op het scherm wordt bijgewerkt.

Inspecteer de browser

Open DevTools, vervolgens het tabblad Network, schakel het kanaal in en kijk naar het SetText-verzoek.
Let op of de browser Mixed Content, Private Network Access of CORS aangeeft, of dat het verzoek nooit wordt verzonden.

Pak waarschuwingen over mixed content of privénetwerk aan

Chrome, Edge of Brave: schakel chrome://flags/#block-insecure-private-network-requests uit en start vervolgens opnieuw op.
Safari: schakel Ontwikkelaar in en vervolgens Disable Cross-Origin Restrictions tijdens het testen.
Firefox: stel network.websocket.allowInsecureFromHTTPS in op true en zorg dat de HTTPS-only-modus uit staat.

Monitor de resultaten

Houd DevTools open terwijl de ondertitels lopen. Als de verzoeken succesvol lijken maar de tekst niet wordt bijgewerkt, maak dan screenshots van de Network-vermelding en het vMix-voorbeeld.
Verzamel de tijdstempel, browserversie, het besturingssysteem en eventuele consolefouten voordat je het escaleert naar support.

Kom je er niet uit?

Als de ondertitels na deze checklist nog steeds niet worden bijgewerkt, open dan de supportwidget in de app en klik op Een ticket aanmaken. Vermeld de tijdstempel, je browserversie, besturingssysteem, vMix-versie en eventuele consolefouten.