Technologie
INTEGRATIONSHANDBUCH

Einsatz des Audiokommentars

Dieser Leitfaden behandelt alles, was Sie für den Einsatz unseres Live-Audiokommentars auf Ihrer Plattform brauchen: das Streamingformat, den Produktions-Feed, empfohlene Player für Web, iOS und Android, die automatische Zuordnung und Antworten auf die häufigsten Integrationsfragen.

01Streaming im Überblick

Unser Live-Audiokommentar wird als Standard-HLS-Stream im sicheren, universellen plattformübergreifenden Format ausgeliefert. Jeder HLS-kompatible Player funktioniert ohne Anpassung. Für das Web empfehlen wir einen Player auf Basis von hls.js, der kostenlos ist und sich in jede HTML-Seite einbetten lässt.

FormatHLS
CodecAAC
Bitrate64, 96, 128 kbps
KanäleMono
PlattformenWeb · iOS · Android

Die Integration ist unkompliziert: Lesen Sie den Produktions-Feed, wählen Sie das gewünschte Spiel und geben Sie die Stream-URL an Ihren Player weiter. Kein proprietäres Protokoll, keine Bindung an einen Player.

02Produktions-Feed

Ihr Produktions-Feed liegt auf einem dauerhaften Endpunkt. Nur der Inhalt wird aktualisiert, die URL ändert sich nie, Sie können sie also auf Ihrer Seite fest hinterlegen.

https://sportsradio.cz/testfeed.php

Feed-Felder

FeldBeschreibung
matchIdEindeutige Spielkennung. Stabile ID, die sich für ein Ereignis nie ändert.
leagueIdKennung der Liga / des Wettbewerbs (EnetpulseID).
homeIdKennung der Heimmannschaft (EnetpulseID).
awayIdKennung der Gastmannschaft (EnetpulseID).
leagueNameName der Liga / des Wettbewerbs.
homeNameName der Heimmannschaft.
awayNameName der Gastmannschaft.
matchDateDatum und Uhrzeit des Spiels, Format Y-m-d H:i:s, UTC.
streamhlsURL des HLS-Streams.
langSprachcode des Kommentars.
countryLänder- / Regionscode. Für internationale Wettbewerbe verwenden wir int.

Die Feed-Struktur lässt sich vollständig an Ihre Anforderungen anpassen. Brauchen Sie zusätzliche Felder, eine Kunden-ID oder sprachspezifische Feeds? Sagen Sie uns einfach Bescheid.

Hinweis: Die URL des Produktions-Feeds ist dauerhaft, die derzeit enthaltenen Stream-Links dienen jedoch nur zum Testen. Beim Go-live werden sie durch echte Produktionslinks ersetzt.

03Empfohlene Player & SDKs

Web

Ein Player auf Basis von hls.js mit Einrichtungsanleitung:

Android

Wir empfehlen ExoPlayer, es funktioniert aber jeder Player mit HLS-Unterstützung. Wir liefern auch ein eigenes SDK auf Basis von ExoPlayer.

iOS

Nutzen Sie den nativen Player von Apple (HLS wird unterstützt) oder unser eigenes iOS-SDK.

04Web-Implementierung (hls.js)

Ein minimales, produktionsreifes Snippet. Laden Sie hls.js, richten Sie es auf die URL streamhls aus dem Feed und hängen Sie es an ein Audio-Element. Unten finden Sie einen Live-Teststream, den Sie sofort abspielen können.

Live-Teststream
Bereit · Play drücken
<!-- 1. Load hls.js (CDN) -->
<script src="https://cdn.jsdelivr.net/npm/hls.js@1/dist/hls.min.js"></script>

<!-- 2. An audio element -->
<audio id="player" controls></audio>

<script>
  const url = "https://xx/playlist.m3u8"; // streamhls from the feed
  const audio = document.getElementById("player");

  if (Hls.isSupported()) {
    const hls = new Hls({ lowLatencyMode: true });
    hls.loadSource(url);
    hls.attachMedia(audio);
  } else if (audio.canPlayType("application/vnd.apple.mpegurl")) {
    audio.src = url; // native HLS (Safari / iOS)
  }
</script>

Das ist die gesamte Web-Integration. Derselbe Ansatz funktioniert auch für einen gestalteten eigenen Player, Sie tauschen nur pro Spiel die URL aus dem Feed.

05Automatische Zuordnung & Feeds

Spielspezifische Links erhalten Sie über Ihren Feed in JSON oder XML, ganz wie Sie möchten. Beispiel einer JSON-Struktur:

[
  {
    "ID": "xxxxx",
    "Home": "xxxx",
    "Away": "xxxx",
    "Time": "xx:xx:xx",
    "Date": "xxxx-xx-xx",
    "Lang": "xx",
    "streamhls": "https://xx/playlist.m3u8"
  }
]

Um die automatische Zuordnung zu aktivieren, senden Sie uns einen ersten Feed mit Liga, Event, Uhrzeit, Datum und Spiel-ID. Wir integrieren Ihre Spiel- und Vereins-IDs und liefern einen Feed mit direkten URLs zum Live-Audiokommentar zurück, was den Einsatz deutlich beschleunigt.

Teststream: Die Links im Beispiel-Feed sind nicht aktiv. Nutzen Sie zum Testen den durchgehenden Live-Stream: livesportradio.com/global/livescore/playlist.m3u8

06FAQ

Q1Wie oft sollten wir die Daten zum Audiokommentar abrufen?

Einmal pro Stunde reicht in den meisten Fällen völlig aus. Der Feed ist kein vollwertiges CDN, bitte fragen Sie ihn daher nicht häufiger als einmal pro Minute ab. Spiel-Links sind in der Regel mindestens eine Woche im Voraus verfügbar, oft bis zu einem Monat. Da sich Anstoßzeiten verschieben können, empfehlen wir eine Prüfung alle 30 bis 60 Minuten.

Q2Wie lange vor dem Anpfiff werden die URLs zum Audiokommentar bereitgestellt?

Spiel-Links sind in der Regel bis zu einem Monat vor dem Anpfiff verfügbar. Bei einzeln ausgewählten Spielen liegt das übliche Fenster bei rund 48 Stunden vorher, nach Absprache auch früher bei Halbfinals, Finals und anderen wichtigen Spielen. Wir können das an Ihren Bedarf anpassen.

Q3Wann beginnt der Audiokommentar?

Die Live-Übertragung beginnt in der Regel 5 Minuten vor dem Anpfiff und bleibt bis 5 Minuten nach dem Schlusspfiff aktiv. Stream-URLs bleiben durchgehend aktiv; außerhalb des Live-Kommentars läuft ein automatischer Loop, der Ihr Branding-Audio tragen kann. In der Halbzeit spielen wir einen Loop (derzeit Stadionatmosphäre), der sich ebenfalls durch eigenes Audio ersetzen lässt, wenn Sie uns das Material schicken. Gern helfen wir beim Aufbau eines Loops mit Ihrem Branding.

Q4Wann erhalten wir Produktionsdaten mit echten URLs zum Audiokommentar?

Die Test-URLs, die wir bereitstellen, sind bereits voll funktionsfähig, im Grunde Links auf Produktionsniveau. Die einzigen Unterschiede: Sie tragen noch nicht Ihr Branding, sind nicht an unser Statistiksystem angebunden, und das CDN-Fallback ist nicht aktiviert. Sie sind zum Testen für rund 1.000 gleichzeitige Nutzer ausgelegt, entsprechen aber genau dem, wie Ihre endgültigen Produktions-URLs aussehen werden.

Q5Erfordern Produktionsdaten eine Authentifizierung?

Ja. Produktions-Feeds sind per IP-Whitelisting gesichert. Senden Sie uns die Liste der IP-Adressen, die Sie freischalten möchten, und wir aktivieren den Zugriff für diese IPs, wenn wir die endgültigen Produktions-URLs bereitstellen.

Bringen wir Live-Sportaudio auf Ihre Plattform.

Erzählen Sie uns, woran Sie arbeiten, und wir finden gemeinsam die passende Lösung.

Demo anfragen