Nasazení audio komentáře
Tento návod pokrývá vše, co potřebujete k nasazení našeho živého audio komentáře na své platformě: formát streamingu, produkční feed, doporučené přehrávače pro web, iOS a Android, automatické párování a odpovědi na nejčastější otázky k integraci.
01Přehled streamingu
Náš živý audio komentář dodáváme jako standardní HLS streamy v zabezpečeném, univerzálním multiplatformním formátu. Jakýkoli přehrávač kompatibilní s HLS funguje bez úprav. Pro web doporučujeme přehrávač postavený na hls.js, který je zdarma a dá se vložit do jakékoli HTML stránky.
Integrace je jednoduchá: načtete produkční feed, vyberete požadovaný zápas a adresu streamu předáte svému přehrávači. Žádný proprietární protokol, žádná vazba na konkrétní přehrávač.
02Produkční feed
Váš produkční feed žije na stálém endpointu. Mění se jen obsah, adresa nikdy, takže ji můžete mít na své straně napevno.
Pole feedu
| Pole | Popis |
|---|---|
matchId | Jedinečný identifikátor zápasu. Stabilní ID, které se u dané události nikdy nemění. |
leagueId | Identifikátor ligy / soutěže (EnetpulseID). |
homeId | Identifikátor domácího týmu (EnetpulseID). |
awayId | Identifikátor hostujícího týmu (EnetpulseID). |
leagueName | Název ligy / soutěže. |
homeName | Název domácího týmu. |
awayName | Název hostujícího týmu. |
matchDate | Datum a čas zápasu, formát Y-m-d H:i:s, UTC. |
streamhls | Adresa HLS streamu. |
lang | Kód jazyka komentáře. |
country | Kód země / regionu. Pro mezinárodní soutěže používáme int. |
Strukturu feedu lze plně přizpůsobit vašim požadavkům. Potřebujete další pole, zákaznické ID nebo feedy pro jednotlivé jazyky? Dejte nám vědět.
03Doporučené přehrávače & SDK
Web
Přehrávač postavený na hls.js s návodem k nastavení:
- Implementační příručka (web): sportsradio.cz/implementationguide.html
Android
Doporučujeme ExoPlayer, funguje ale jakýkoli přehrávač s podporou HLS. Dodáváme i vlastní SDK postavené na ExoPlayeru.
- ExoPlayer: github.com/google/ExoPlayer
- Přehrávač GBVision pro Android (ZIP): stáhnout zde
- Přístup do GitLabu: o repozitář si napište.
iOS
Použijte nativní přehrávač Apple (podporuje HLS) nebo naše vlastní iOS SDK.
- Přehrávač GBVision pro iOS: github.com/alvitres01/gb_vision_player_ios
04Implementace na webu (hls.js)
Minimální úryvek připravený pro produkci. Načtěte hls.js, nasměrujte ho na adresu streamhls z feedu a připojte k audio prvku. Níže je živý testovací stream, který si můžete hned pustit.
<!-- 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>To je celá integrace na webu. Stejný postup funguje i pro vlastní nastylovaný přehrávač, jen u každého zápasu vyměníte adresu z feedu.
05Automatické párování & feedy
Odkazy ke konkrétním zápasům dostáváte přes svůj feed v JSON nebo XML, podle toho, co vám vyhovuje. Příklad struktury JSON:
[
{
"ID": "xxxxx",
"Home": "xxxx",
"Away": "xxxx",
"Time": "xx:xx:xx",
"Date": "xxxx-xx-xx",
"Lang": "xx",
"streamhls": "https://xx/playlist.m3u8"
}
]Pro zapnutí automatického párování nám pošlete výchozí feed s ligou, událostí, časem, datem a ID zápasu. Napojíme vaše ID zápasů a klubů a vrátíme feed s přímými adresami živého audio komentáře, což nasazení výrazně zrychlí.
06FAQ
Q1Jak často máme data audio komentáře stahovat?
Ve většině případů bohatě stačí jednou za hodinu. Feed není plnohodnotná CDN, takže se prosím neptejte častěji než jednou za minutu. Odkazy na zápasy bývají k dispozici nejméně týden předem, často až měsíc. Protože se časy zápasů mohou posouvat, doporučujeme kontrolu každých 30 až 60 minut.
Q2Jak dlouho před výkopem jsou adresy audio komentáře k dispozici?
Odkazy na zápasy bývají k dispozici až měsíc před výkopem. U ručně vybíraných zápasů je obvyklé okno zhruba 48 hodin předem, po domluvě i dříve u semifinále, finále a dalších klíčových utkání. Můžeme to přizpůsobit vašim potřebám.
Q3Kdy audio komentář začíná?
Živé vysílání obvykle začíná 5 minut před výkopem a zůstává aktivní do 5 minut po závěrečném hvizdu. Adresy streamů jsou aktivní nepřetržitě; mimo živý komentář hraje automatická smyčka, která může nést váš brandingový zvuk. O poločase pouštíme smyčku (momentálně ruch stadionu), kterou lze také nahradit vlastním zvukem, pokud nám pošlete podklady. Rádi vám se smyčkou na míru pomůžeme.
Q4Kdy dostaneme produkční data se skutečnými adresami audio komentáře?
Testovací adresy, které poskytujeme, jsou už plně funkční, v podstatě na produkční úrovni. Jediné rozdíly: zatím nenesou váš branding, nejsou napojené na náš systém statistik a není zapnutá záloha přes CDN. Pro testování jsou připravené zhruba pro 1 000 souběžných uživatelů, přesně ale odpovídají tomu, jak budou vypadat vaše konečné produkční adresy.
Q5Budou produkční data vyžadovat ověření?
Ano. Produkční feedy jsou zabezpečené povolením vybraných IP adres. Pošlete nám seznam IP adres, které chcete autorizovat, a přístup pro ně zapneme ve chvíli, kdy vám předáme konečné produkční adresy.
Přineste živý sportovní zvuk na svou platformu.
Řekněte nám, na čem pracujete, a společně najdeme to správné řešení.