Automatische DJ-Erkennung: Wie richte ich JSON-Status-API, DJ-Namen und Avatare ein?

Was macht die automatische DJ-Erkennung?

ET-HOST kann im Radioplayer den DJ anzeigen, der tatsächlich auf dem Streamingserver sendet. Dafür muss der Streaminganbieter über eine öffentlich abrufbare HTTPS-Statusschnittstelle den Namen des gerade sendenden Moderators bereitstellen. Die Funktion wird in allen Chats angeboten und ist zunächst aktiviert; das allein bedeutet aber nicht, dass eine gültige Datenquelle hinterlegt ist.

Wichtig: Eine MP3-/AAC-Streamadresse ist keine DJ-Status-API. Auch Songtitel oder der Name einer Playlist beweisen nicht, welcher Mensch gerade sendet.

Schritt 1: Erkennung im Betreiber-Admin einrichten

1. Öffne deinen Chat und melde dich im Betreiber-Admin an.
2. Gehe zum Menüpunkt „Radioplayer“ (Bereich Radio).
3. Suche den Abschnitt „Automatische DJ-Erkennung“.
4. Aktiviere die Checkbox „Automatische Erkennung aktivieren“, sofern sie noch nicht aktiviert ist.
5. Trage im Feld „HTTPS-Status-API des Streaminganbieters“ die tatsächliche JSON-Statusadresse deines Streaminganbieters ein – NICHT die normale Player- oder Stream-URL.
6. Falls der Anbieter statt deines Chatnicknamens einen anderen Sendernamen übermittelt, hinterlege eine Zuordnung im Feld „DJ-Namen zuordnen“.
7. Speichere die Radioplayer-Einstellungen. Starte danach eine Live-Sendung und öffne den Chat-Player erneut.

Schritt 2: Die richtige JSON- oder Status-URL finden

• Frage deinen Streaminganbieter nach einer öffentlichen HTTPS-JSON-Status-API, die den tatsächlich verbundenen Live-DJ benennt. Eine reine Hörerzahl- oder Songtitel-API genügt nicht.
• Eine gültige Antwort besteht aus JSON-Daten mit einem DJ-Namen, beispielsweise {"is_live":true,"dj_name":"DJ Michael"}.
• Ebenfalls unterstützt werden die Textfelder dj, streamer, live_dj, djname, live_dj_name, current_dj, streamer_name und onair_dj. ET-HOST verarbeitet außerdem übliche Umhüllungen unter data, status oder stream.
• AzuraCast: Eine kompatible JSON-Antwort enthält live.is_live=true und live.streamer_name="DJ Michael". Das spezielle AzuraCast-Format wird unterstützt.
• Ein AutoDJ kann von einer kompatiblen API durch z. B. {"is_autodj":true} gemeldet werden.
• CentovaCast: Wenn du im Radioplayer bereits eine gültige HTTPS-CentovaCast-Paneladresse und einen Stationsbenutzernamen hinterlegt hast, kann ET-HOST als Ersatzquelle dessen öffentliche Streaminfo-Schnittstelle versuchen. Das klappt nur, wenn der Anbieter darüber einen tatsächlich auswertbaren DJ-Namen liefert.
• Bei Shoutcast, Icecast und anderen Anbietern hängt die DJ-Erkennung davon ab, ob die jeweilige öffentliche Status-API den DJ-Namen tatsächlich ausgibt. Nicht jede Anbieter-API unterstützt dies.
• Die Statusadresse muss über HTTPS abrufbar sein, gültiges JSON liefern und vom ET-HOST-Server erreichbar sein. Keine Benutzerpasswörter, privaten API-Tokens oder eingebetteten Login-Daten in eine öffentliche Status-URL eintragen.

Schritt 3: DJ-Namen mit dem Chatprofil verknüpfen

Der vom Streamingserver übermittelte DJ-Name wird zuerst mit einem aktiven Chatkonto verglichen. Der Chatnickname muss übereinstimmen oder über eine Zuordnung hinterlegt sein.

Beispiel: Der Streaminganbieter meldet „Studio DJ“, das Chatkonto heißt „Michael“. Trage in „DJ-Namen zuordnen“ genau eine Zeile ein: Studio DJ=Michael

Für weitere Personen nutzt du je eine eigene Zeile: Anbietername=Chatnickname.

Das Konto muss in diesem Chat aktiv sein und eine zum Radiobetrieb berechtigte Rolle besitzen. Ein beliebiger Gast- oder Standardbenutzer wird nicht automatisch mit einem DJ-Avatar verknüpft.

Schritt 4: Das DJ-Profilbild im Player anzeigen

1. Der betreffende DJ meldet sich im richtigen Chatkonto an und hinterlegt ein Profilbild (Avatar).
2. Prüfe, ob sein Konto aktiv ist und die passende Moderatoren- oder Radio-Rolle hat.
3. Stelle sicher, dass der Streaminganbieter genau den Namen liefert, der per Chatnickname oder Zuordnungsregel diesem Konto entspricht.
4. Starte eine Live-Sendung. Die Erkennung wird serverseitig zwischengespeichert und typischerweise etwa alle 30 Sekunden neu ermittelt.
5. Bei erfolgreicher Erkennung mit passendem Chatkonto zeigt der Player dessen Avatar an. Ohne passenden Avatar kann ein Live-DJ namentlich erkannt sein, aber kein Profilbild erscheinen.

Hinweis: Ein im DJ-Panel oder Sendeplan eingetragenes Bild ersetzt nicht automatisch das Avatarbild des erkannten Chatkontos.

Schritt 5: AutoDJ richtig konfigurieren

Unterhalb der DJ-Erkennung befindet sich der Abschnitt „AutoDJ“. Aktiviere bei Bedarf „AutoDJ als Standard-DJ im Player anzeigen“, trage einen Namen ein und lade ein eigenes AutoDJ-Bild hoch.

Der AutoDJ ist nicht mit einem live sendenden Moderator gleichzusetzen. Die automatische DJ-Erkennung kann einen AutoDJ anzeigen, wenn die Status-API ihn als solchen meldet; ansonsten kann der Player bei unklaren Daten auch „DJ nicht ermittelbar“ anzeigen.

Wichtig: Mit eingeschalteter automatischer DJ-Erkennung wird der manuelle Chatstatus „On Air“ nicht als Nachweis für den wirklich verbundenen DJ verwendet. Wenn dein Anbieter keinen DJ-Namen liefert, ist ein dauerhaft sichtbarer DJ-Avatar durch bloßes „On Air“-Setzen deshalb nicht gewährleistet. Betreiber können die automatische Erkennung deaktivieren, wenn sie bewusst stattdessen mit der manuellen On-Air-Anzeige arbeiten möchten.

Was wird tatsächlich überprüft?

• Verbindungsquelle: Ist die JSON-Adresse vorhanden, über HTTPS erreichbar und liefert sie HTTP 200?
• Inhalt: Meldet die JSON-Antwort tatsächlich einen Namen des aktiven Live-DJs oder ein AutoDJ-Signal?
• Zuordnung: Entspricht dieser Name einem aktiven Chatkonto mit geeigneter Radio-Rolle?
• Profil: Hat dieses Konto einen Avatar? Beim AutoDJ: Ist ein AutoDJ-Bild hinterlegt?
• Anzeige: Erscheinen die Daten nach dem Speichern und Aktualisieren im Player?

Häufige Probleme

• „DJ nicht ermittelbar“: Erkennung aktiviert, aber keine nutzbare Status-API, keine DJ-Information in der API oder kurzzeitiger Abruffehler.
• DJ-Name sichtbar, aber Bild fehlt: Chatnickname und Anbietername passen nicht zusammen; Zuordnung fehlt; Konto ist nicht aktiv, hat keine passende Radio-Rolle oder besitzt keinen Avatar.
• Nur AutoDJ sichtbar: Die API meldet AutoDJ oder es läuft derzeit kein erkennbarer Live-DJ. Prüfe die Live-Übertragung und die API-Rückgabe.
• Stream läuft, aber kein DJ erkannt: Das ist möglich. Ein funktionierender Radiostream belegt nicht, dass die API eine DJ-Identität übermittelt.
• Änderungen erscheinen nicht sofort: Warte kurz wegen des ungefähr 30-sekündigen Caches und aktualisiere den Chat.

Sicherheit und Datenschutz

Die Status-API wird serverseitig von ET-HOST abgefragt. Nutze nur eine vom Anbieter ausdrücklich vorgesehene öffentliche HTTPS-Schnittstelle und gib keine Zugangsdaten oder vertraulichen Schlüssel in das Feld ein. ET-HOST verifiziert die DJ-Identität anhand der Statusdaten und der Chatkontenzuordnung – nicht anhand von Songtiteln oder bloßer Chat-Anwesenheit.

Wenn du nicht weiterkommst

Erstelle im ET-HOST-Supportcenter ein Ticket. Teile den Radionamen, die Art des Streaminganbieters, den angezeigten Playerstatus und – sofern öffentlich – die HTTPS-Status-URL mit. Teile niemals Streamingpasswörter, private Tokens oder Sessiondaten.