Audio commentary deployment
This guide covers everything you need to deploy our live audio commentary on your platform: the streaming format, the production feed, recommended players for web, iOS and Android, automatic pairing, and answers to the most common integration questions.
01Streaming overview
Our live audio commentary is delivered as standard HLS streams using the secure, universal cross-platform format. Any HLS-compatible player works out of the box. For web we recommend a player based on hls.js, which is free and embeds into any HTML page.
Integration is straightforward: read the production feed, select the match you want, and hand the stream URL to your player. No proprietary protocol, no player lock-in.
02Production feed
Your production feed lives at a permanent endpoint. Only the contents update, the URL never changes, so you can hard-code it on your side.
Feed fields
| Field | Description |
|---|---|
matchId | Unique match identifier. Stable ID, never changes for a given event. |
leagueId | League / competition identifier (EnetpulseID). |
homeId | Home team identifier (EnetpulseID). |
awayId | Away team identifier (EnetpulseID). |
leagueName | League / competition name. |
homeName | Home team name. |
awayName | Away team name. |
matchDate | Match date and time, format Y-m-d H:i:s, UTC. |
streamhls | HLS stream URL. |
lang | Commentary language code. |
country | Country / region code. We use int for international competitions. |
The feed structure can be fully customised to your requirements. Need extra fields, a customer ID, or language-specific feeds? Just let us know.
03Recommended players & SDKs
Web
An hls.js-based player with setup instructions:
- Implementation Guide (Web): sportsradio.cz/implementationguide.html
Android
We recommend ExoPlayer, though any HLS-supported player works. We also ship our own ExoPlayer-based SDK.
- ExoPlayer: github.com/google/ExoPlayer
- GBVision Android player (ZIP): download here
- GitLab access: contact us to request the repository.
iOS
Use Apple’s native player (HLS supported), or our own iOS SDK.
- GBVision iOS player: github.com/alvitres01/gb_vision_player_ios
04Web implementation (hls.js)
A minimal, production-ready snippet. Load hls.js, point it at the streamhls URL from the feed, and attach it to an audio element. Below is a live test stream you can play right now.
<!-- 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>That is the whole web integration. The same approach scales to a styled custom player, you only swap the URL per match from the feed.
05Automatic pairing & feeds
Match-specific links are delivered through your feed in JSON or XML, whichever you prefer. Example JSON structure:
[
{
"ID": "xxxxx",
"Home": "xxxx",
"Away": "xxxx",
"Time": "xx:xx:xx",
"Date": "xxxx-xx-xx",
"Lang": "xx",
"streamhls": "https://xx/playlist.m3u8"
}
]To enable automatic pairing, send us an initial feed with League, Event, Time, Date and Match ID. We integrate your match IDs and club IDs and return a feed with direct live audio commentary URLs, which dramatically speeds up deployment.
06FAQ
Q1How often should we pull the audio commentary data?
Once per hour is more than enough in most cases. The feed is not a full-scale CDN, so please avoid polling more frequently than once per minute. Match links are usually available at least a week ahead, often up to a month. Since match times can shift, checking every 30 to 60 minutes is the recommended approach.
Q2How long before kick-off are the audio commentary URLs provided?
Match links are typically available up to one month before kick-off. For hand-picked matches the usual window is around 48 hours prior, or earlier by arrangement for semi-finals, finals and other key fixtures. We can adjust this to your needs.
Q3When does the audio commentary begin?
Live broadcast generally starts 5 minutes before kick-off and stays active until 5 minutes after the final whistle. Stream URLs remain active continuously; outside live commentary an automated loop plays, which can carry your branding audio. During halftime we play a loop (currently ambient stadium sound), also replaceable with custom audio if you send us the material. We are happy to help build a branded loop.
Q4When do we get production data with real audio commentary URLs?
The test URLs we provide are already fully functional, essentially production-level links. The only differences: they do not yet carry your branding, they are not connected to our stats system, and CDN fallback is not enabled. They are provisioned for roughly 1,000 concurrent users for testing, but reflect exactly what your final production URLs will look like.
Q5Will production data require authentication?
Yes. Production feeds are secured through IP whitelisting. Send us the list of IP addresses you want to authorise and we enable access for those IPs when we provide the final production URLs.
Let’s bring live sports audio to your platform.
Tell us what you are building and we’ll explore the right solution together.