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.
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.
Feed-Felder
| Feld | Beschreibung |
|---|---|
matchId | Eindeutige Spielkennung. Stabile ID, die sich für ein Ereignis nie ändert. |
leagueId | Kennung der Liga / des Wettbewerbs (EnetpulseID). |
homeId | Kennung der Heimmannschaft (EnetpulseID). |
awayId | Kennung der Gastmannschaft (EnetpulseID). |
leagueName | Name der Liga / des Wettbewerbs. |
homeName | Name der Heimmannschaft. |
awayName | Name der Gastmannschaft. |
matchDate | Datum und Uhrzeit des Spiels, Format Y-m-d H:i:s, UTC. |
streamhls | URL des HLS-Streams. |
lang | Sprachcode des Kommentars. |
country | Lä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.
03Empfohlene Player & SDKs
Web
Ein Player auf Basis von hls.js mit Einrichtungsanleitung:
- Implementierungsleitfaden (Web): sportsradio.cz/implementationguide.html
Android
Wir empfehlen ExoPlayer, es funktioniert aber jeder Player mit HLS-Unterstützung. Wir liefern auch ein eigenes SDK auf Basis von ExoPlayer.
- ExoPlayer: github.com/google/ExoPlayer
- GBVision Android-Player (ZIP): hier herunterladen
- GitLab-Zugang: Kontaktieren Sie uns, um das Repository anzufragen.
iOS
Nutzen Sie den nativen Player von Apple (HLS wird unterstützt) oder unser eigenes iOS-SDK.
- GBVision iOS-Player: github.com/alvitres01/gb_vision_player_ios
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.
<!-- 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.
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.