vMix-Integration

Senden Sie Live-Untertitel an vMix für Broadcast-Produktionen.

Übersicht

Senden Sie Echtzeit-Untertitel an vMix für Broadcast-Produktionen. Maestra läuft auf demselben Computer wie vMix und sendet Ihre Live-Untertitel in einen vMix-Titeleingang.

Bevor Sie beginnen

Verwenden Sie Google Chrome und halten Sie es auf der neuesten Version.
Stellen Sie sicher, dass vMix läuft und der vMix Web Controller aktiviert ist.
Öffnen Sie Maestra im selben Browser, auf demselben Rechner wie vMix.

So richten Sie es ein

Sie müssen vMix auf demselben Computer ausführen, auf dem auch Maestra Live läuft.
Laden Sie diese Titelvorlage herunter, die Untertitel in vMix anzeigt. Importieren Sie diese Titelvorlage in vMix, indem Sie zu Add Input > Title/XAML gehen. Klicken Sie oben rechts im Fenster Input Select auf Browse... und wählen Sie die heruntergeladene Titelvorlagendatei aus. Klicken Sie auf OK.
Gehen Sie in vMix zu Settings > Web Controller und aktivieren Sie das Kontrollkästchen, um den Web Controller zu aktivieren.
Legen Sie den Port fest oder übernehmen Sie den Standardwert.
Kopieren Sie die "vMix Web Site Address" und fügen Sie sie in Maestra ein.
Laden Sie optional die Maestra Companion App für ein nahtloseres Erlebnis herunter. Sobald sie installiert ist und läuft, aktivieren Sie sie in den vMix-Kanaleinstellungen, aktualisieren Sie die Seite und genießen Sie Untertitel in vMix.

Fehlerbehebung

Wenn die Untertitel aus Ihrer Maestra-Echtzeit-Session nicht in vMix ankommen, arbeiten Sie diese Checkliste der Reihe nach durch. Jeder Schritt schließt eine häufige Ursache aus, von den Web-Controller-Einstellungen und Chrome-Netzwerkberechtigungen bis hin zu Firewalls, Ports und der vMix-Untertitelvorlage. Hören Sie auf, sobald die Untertitel auf dem Bildschirm zu aktualisieren beginnen.

Checkliste

Die Grundlagen bestätigen

Führen Sie den vMix Web Controller auf demselben Rechner aus wie den Browser, der Maestra verwendet.
Stellen Sie sicher, dass der Kanal auf die richtige vMix-URL verweist (Standard http://localhost:8088) und der Titel oder die Vorlagen-GUID der Untertitel übereinstimmt.

Die Sicherheitsoptionen des Web Controllers überprüfen

Lassen Sie Allow software on this computer access without login aktiviert.
Lassen Sie Enable enhanced security on Web and TCP API deaktiviert.
Lassen Sie Restrict access to LAN only deaktiviert.

Den Zugriff auf das lokale Netzwerk in Chrome aktivieren

Öffnen Sie chrome://settings/content/all, suchen Sie dann nach live.maestra.ai und wählen Sie es aus (oder verwenden Sie das Schloss-Symbol, dann Website-Einstellungen).
Setzen Sie Zugriff auf das lokale Netzwerk auf Zulassen, laden Sie Maestra neu und versuchen Sie es erneut.

Die Netzwerkerreichbarkeit prüfen

Öffnen Sie auf diesem Rechner die Web-Controller-URL (zum Beispiel http://localhost:8088) in einem beliebigen Browser.
Wenn sie nicht lädt oder träge ist, beheben Sie das zuerst: Starten Sie vMix, korrigieren Sie den Port und geben Sie Firewalls frei.

Einen anderen Port ausprobieren

Wenn 8088 weiterhin fehlschlägt, ändern Sie den vMix Web Controller auf einen unbenutzten hohen Port (zum Beispiel 2025), aktualisieren Sie die URL in Maestra und testen Sie erneut.
Dies umgeht oft unternehmensinterne Sicherheitsfilter oder veraltete Listener, die an gängige Ports gebunden sind.

Unternehmens- oder VPN-Sperren ausschließen

Trennen Sie vorübergehend VPNs, Endpunkt-Firewalls oder Antivirenprogramme, die HTTPS-Seiten den Zugriff auf http://localhost untersagen könnten.
Wenn die Untertitel zu funktionieren beginnen, setzen Sie vMix und den Browser auf die Whitelist und aktivieren Sie die Sicherheitstools dann wieder.

Die vMix-Vorlage validieren

Stellen Sie im Title Designer sicher, dass das Feld WebCaptionerCaptions vorhanden ist und die GUID mit den Maestra-Einstellungen übereinstimmt.
Bearbeiten Sie das Feld in vMix manuell, um zu bestätigen, dass es auf dem Bildschirm aktualisiert wird.

Den Browser untersuchen

Öffnen Sie die DevTools, dann den Tab Netzwerk, aktivieren Sie den Kanal und beobachten Sie die SetText-Anfrage.
Achten Sie darauf, ob der Browser Mixed Content, Private Network Access oder CORS meldet oder ob die Anfrage nie versendet wird.

Warnungen zu Mixed Content oder privatem Netzwerk beheben

Chrome, Edge oder Brave: Deaktivieren Sie chrome://flags/#block-insecure-private-network-requests und starten Sie dann neu.
Safari: Schalten Sie während des Testens Entwickeln, dann Disable Cross-Origin Restrictions ein.
Firefox: Setzen Sie network.websocket.allowInsecureFromHTTPS auf true und stellen Sie sicher, dass der Nur-HTTPS-Modus deaktiviert ist.

Die Ergebnisse beobachten

Lassen Sie die DevTools geöffnet, während die Untertitel laufen. Wenn die Anfragen erfolgreich aussehen, der Text aber nicht aktualisiert wird, erstellen Sie Screenshots des Netzwerkeintrags und der vMix-Vorschau.
Erfassen Sie den Zeitstempel, die Browserversion, das Betriebssystem und alle Konsolenfehler, bevor Sie an den Support eskalieren.

Immer noch Probleme?

Wenn die Untertitel nach dieser Checkliste weiterhin nicht aktualisiert werden, öffnen Sie das Support-Widget in der App und klicken Sie auf Ticket erstellen. Bitte geben Sie den Zeitstempel, Ihre Browserversion, Ihr Betriebssystem, Ihre vMix-Version und alle Konsolenfehler an.