Premium-Plugin Live-Interview-Bridge ← zurück zum Hub

Live-Interview-Bridge

Private Vorgespräche und Live-Interviews direkt über DGNCast senden

Die Live-Interview-Bridge verbindet einen Moderator und einen Gast zunächst in einem privaten Gesprächsraum. Erst nach der bewussten On-Air-Freigabe wird der Gesprächston an DGNCast übertragen. Das laufende Musikprogramm bleibt aktiv und wird beim Sprechen automatisch abgesenkt.

Aktueller Stand: Live-Interview-Bridge 0.3.6 mit Android-Moderator-App 0.3.2. Vor dem regulären Sendebetrieb sollte der vollständige Zwei-Handy-Test durchgeführt werden.


Was du damit machen kannst

Privates Vorgespräch

Moderator und Gast können miteinander sprechen, ohne dass das Gespräch im Radiostream zu hören ist. Auch während zwei laufender Musiktitel bleibt die private Verbindung bestehen.

Bewusst auf Sendung gehen

Der Moderator schaltet das Gespräch in der Android-App über den On-Air-Schalter frei. DGNCast übernimmt den Gesprächston und senkt die Musik automatisch ab. Wird On Air wieder ausgeschaltet, bleibt das Gespräch privat und die Musik läuft normal weiter.

Sicher reagieren

Ein separater Betreiber-Not-Aus beendet den Sendetransport sofort. Dieser Riegel kann nur bewusst durch einen berechtigten Betreiber aufgehoben werden.

Optionales Video

Moderator und Gast können ihre Kamera bei Bedarf einschalten. Das Bild bleibt im privaten Gesprächsraum und wird nicht an den Radiostream übertragen.


Voraussetzungen

Eine neue Hauptdomain ist nicht erforderlich. Eine Subdomain reicht aus. Der A-Record muss auf die öffentliche IPv4-Adresse des Servers zeigen, auf dem LiveKit und coturn installiert werden. Ein AAAA-Eintrag sollte nur gesetzt werden, wenn IPv6 auf diesem Server vollständig eingerichtet ist.


Installation und Aktivierung

  1. Öffne im RadioCMS den Bereich Plugins und anschließend den Marketplace.
  2. Suche nach Live-Interview-Bridge.
  3. Öffne Plugin laden und Lizenz.
  4. Trage deinen Lizenzschlüssel im Format RCMS-XXXX-XXXX-XXXX-XXXX ein.
  5. Nach erfolgreicher Prüfung wird das Plugin automatisch heruntergeladen.
  6. Öffne danach die Plugin-Liste und aktiviere die Live-Interview-Bridge.
  7. Im Adminmenü erscheint anschließend der Bereich Interviews.

Interview-Server einrichten

Das Plugin bringt unter install/install-interview-server.sh einen geprüften Installer für Debian 12 und Ubuntu 22.04 oder neuer mit. Das Skript muss als Root auf dem vorgesehenen Interview-Server ausgeführt werden.

Beispiel:

bash install-interview-server.sh --domain interview.dein-radio.de

Benötigte eingehende Ports:

Protokoll Ports Zweck
TCP 7880 LiveKit Signaling, intern auch hinter dem HTTPS-Proxy
TCP 7881 WebRTC TCP-Fallback
TCP und UDP 3478 TURN und STUN
TCP 5349 TURN über TLS
UDP 7882 LiveKit Medienverkehr
UDP 49152 bis 49400 TURN Relay

Nach der Installation müssen alle Dienste aktiv sein:

systemctl status livekit-server --no-pager -l
systemctl status coturn --no-pager -l
systemctl status redis-server --no-pager -l
docker ps --filter name=livekit-egress

Falls der Installer meldet, dass mindestens ein Dienst nicht läuft, zeigen diese Befehle die eigentliche Ursache:

journalctl -u livekit-server -n 100 --no-pager
journalctl -u coturn -n 100 --no-pager

Die vollständigen Zugangsdaten liegen anschließend ausschließlich auf dem Server unter /etc/livekit/keys.env. Teile diese Werte nicht in Bildschirmfotos oder öffentlichen Nachrichten.


RadioCMS mit den Diensten verbinden

  1. Öffne Interviews, Einstellungen.
  2. Trage die LiveKit-Adresse, API-Daten und TURN-Daten ein.
  3. Trage die DGNCast-API-Adresse, den DGNCast-Adminzugang, die Stream-ID und den öffentlichen Streaming-Port ein.
  4. Verwende bei einer eigenständigen zusätzlichen DGNCast-Instanz deren eigenen API-Port, deren eigenen Admin-Zugang und normalerweise wieder Stream-ID 1.
  5. Klicke auf Speichern und DGNCast testen. Die Erfolgsmeldung zeigt die tatsächlich geprüfte API-Adresse, Stream-ID und den öffentlichen Port.
  6. Öffne DGNCast-Steuerung und aktiviere die Interview-Quelle.
  7. Wähle für den ersten Test die Ducking-Stufe Normal, minus 15 dB.
  8. Erzeuge einen Interview-Zugang.

Beispiel für zwei eigenständige DGNCast-Instanzen

EinstellungHauptstreamZweite Instanz
DGNCast-API-Adressehttp://127.0.0.1:8000http://127.0.0.1:8020
Stream-ID11
Streaming-Port80008020
Admin-ZugangZugang der ersten InstanzZugang der zweiten Instanz

Stream-ID 2 ist nur richtig, wenn die ausgewählte DGNCast-API diesen Stream tatsächlich als SID 2 führt. Ein anderer öffentlicher Streaming-Port allein wechselt weder die API noch deren Zugangsdaten.

Verwende immer den API-Admin-Benutzernamen und das API-Admin-Passwort genau dieser Instanz. Der Panel-Login und das DJ-/Sendepasswort sind nicht automatisch derselbe Zugang. Bei einer zweiten Instanz können sich sowohl Benutzername als auch Passwort vom Hauptstream unterscheiden.

RadioCMS verwaltet derzeit eine ausgewählte DGNCast-Verbindung. Beim Wechsel zwischen eigenständigen Instanzen müssen API-Adresse, Stream-ID, Streaming-Port und Admin-Zugang gemeinsam umgestellt werden. Ein bereits erzeugter Interview-Zugang bleibt auf der vorherigen Instanz erhalten. Entziehe einen nicht mehr benötigten Testzugang deshalb vor dem Wechsel.

Nach einem Wechsel der API-Adresse oder Stream-ID verwirft RadioCMS den lokal gespeicherten Interview-Schlüssel. Erzeuge anschließend einen neuen Zugang für die neu ausgewählte Instanz.

Verbindungstest und Anmeldefehler

Speichern und DGNCast testen prüft den API-Zugang nach einem älteren Anmeldefehler ausdrücklich erneut. Automatische Abfragen bleiben nach falschen Zugangsdaten gestoppt. Wiederholte fehlgeschlagene manuelle Tests mit unveränderten Daten sind auf drei Versuche in 15 Minuten mit mindestens 30 Sekunden Abstand begrenzt. Eine von DGNCast vorgegebene Wartezeit wird niemals verkürzt. Korrigiere zuerst Benutzername und Passwort, statt wiederholt einen Sendestart auszulösen.

Der getrennte Schalter LiveKit-Verbindung testen prüft nur den Interview-Server, nicht die DGNCast-Anmeldung.

Zweiter Stream im Player

Die Interview-Einstellungen schalten den normalen Radioplayer nicht um. Auch Audio-Adresse und Status-Adresse des zweiten Players müssen zur zweiten Instanz gehören. Eine öffentliche Adresse wie /live2.mp3 kann beispielsweise auf den internen Mount http://127.0.0.1:8020/live.mp3 zeigen. Eine exakte Nginx-Location verhindert, dass eine allgemeine Audio-Regel den Aufruf an den Hauptstream weiterleitet.

Verwende einen getrennten öffentlichen Status-Pfad, beispielsweise /live2/stats für SHOUTcast-XML oder /live2/7.html für das klassische SHOUTcast-Format, jeweils mit der tatsächlichen SID der zweiten Instanz. /stats am Hauptstream liefert nicht die Daten von Stream 2. Die geschützte Admin-API und Zugangsdaten dürfen nicht öffentlich weitergeleitet werden.


Android-App und Gast verbinden

  1. Installiere die bereitgestellte Moderator-App auf dem Android-Handy.
  2. Öffne im RadioCMS Interviews, Moderator-App.
  3. Erzeuge einen einmaligen Kopplungscode.
  4. Öffne den QR-Code mit dem Moderator-Handy oder trage Adresse und Code manuell ein.
  5. Bereite in der App ein neues Interview vor.
  6. Teile den Gastlink mit dem Gesprächspartner.
  7. Der Gast öffnet den Link im Handy-Browser und erlaubt den Mikrofonzugriff.

Sicherer erster Test

  1. Nutze auf beiden Handys Kopfhörer.
  2. Führe das Gespräch zunächst mit On Air aus. Im Radiostream darf nur das normale Programm zu hören sein.
  3. Schalte On Air ein. Beide Stimmen müssen im Radiostream verständlich zu hören sein.
  4. Die App darf Interview auf Sendung erst nach bestätigtem LiveKit-Sendeweg und bestätigter DGNCast-Gastverbindung anzeigen. Fehlt die Bestätigung, wird der Sendeweg sicher beendet.
  5. Mache mindestens 30 Sekunden Sprechpause. Die Verbindung muss weiterhin bestehen, auch wenn gerade keine Audioaktivität vorliegt.
  6. Prüfe, ob DGNCast die Musik beim Sprechen weich absenkt und danach wieder anhebt.
  7. Schalte mehrfach zwischen privatem Gespräch und On Air um.
  8. Prüfe den Betreiber-Not-Aus.
  9. Teste anschließend Kamera, Rauschunterdrückung, Echounterdrückung und einen Gastwechsel.

Aufnahme und Einwilligung

Informiere alle Beteiligten vor Beginn verständlich über die Live-Ausstrahlung und eine mögliche Aufnahme. Hole die erforderliche Einwilligung ein. Der technische Hinweis des Plugins ist eine Vorlage und ersetzt keine rechtliche Prüfung für den konkreten Einsatz.


Bei einem Fehler

Schicke bei Problemen bitte folgende Angaben:

Die Protokolle von LiveKit und coturn sind für Serverfehler entscheidend. Zugangsdaten und vollständige Lizenzschlüssel dürfen dabei nicht mitgesendet werden.


RadioCMS Community, Live-Interview-Bridge 0.3.6, Stand 31.08.2026