Implementarea comentariului audio
Acest ghid acoperă tot ce aveți nevoie pentru a implementa comentariul nostru audio live pe platforma dumneavoastră: formatul de streaming, feedul de producție, playerele recomandate pentru web, iOS și Android, asocierea automată și răspunsurile la cele mai frecvente întrebări despre integrare.
01Prezentarea streamingului
Comentariul nostru audio live este livrat ca streamuri HLS standard, în formatul securizat, universal și multiplatformă. Orice player compatibil cu HLS funcționează fără modificări. Pentru web recomandăm un player bazat pe hls.js, care este gratuit și se poate integra în orice pagină HTML.
Integrarea este simplă: citiți feedul de producție, selectați meciul dorit și transmiteți URL-ul streamului către playerul dumneavoastră. Fără protocol proprietar, fără dependență de un anumit player.
02Feed de producție
Feedul dumneavoastră de producție se află la un endpoint permanent. Se actualizează doar conținutul, URL-ul nu se schimbă niciodată, așa că îl puteți fixa în sistemul dumneavoastră.
Câmpurile feedului
| Câmp | Descriere |
|---|---|
matchId | Identificator unic al meciului. ID stabil, care nu se schimbă niciodată pentru un anumit eveniment. |
leagueId | Identificatorul ligii / competiției (EnetpulseID). |
homeId | Identificatorul echipei gazdă (EnetpulseID). |
awayId | Identificatorul echipei oaspete (EnetpulseID). |
leagueName | Numele ligii / competiției. |
homeName | Numele echipei gazdă. |
awayName | Numele echipei oaspete. |
matchDate | Data și ora meciului, format Y-m-d H:i:s, UTC. |
streamhls | URL-ul streamului HLS. |
lang | Codul limbii comentariului. |
country | Codul țării / regiunii. Pentru competițiile internaționale folosim int. |
Structura feedului poate fi personalizată complet după cerințele dumneavoastră. Aveți nevoie de câmpuri suplimentare, de un ID de client sau de feeduri pe limbi? Spuneți-ne.
03Playere & SDK-uri recomandate
Web
Un player bazat pe hls.js, cu instrucțiuni de configurare:
- Ghid de implementare (web): sportsradio.cz/implementationguide.html
Android
Recomandăm ExoPlayer, deși funcționează orice player cu suport HLS. Oferim și propriul nostru SDK bazat pe ExoPlayer.
- ExoPlayer: github.com/google/ExoPlayer
- Player GBVision pentru Android (ZIP): descărcați de aici
- Acces GitLab: contactați-ne pentru a solicita depozitul.
iOS
Folosiți playerul nativ Apple (cu suport HLS) sau propriul nostru SDK pentru iOS.
- Player GBVision pentru iOS: github.com/alvitres01/gb_vision_player_ios
04Implementare web (hls.js)
Un fragment de cod minimal, gata de producție. Încărcați hls.js, indicați-i URL-ul streamhls din feed și atașați-l unui element audio. Mai jos este un stream de test live pe care îl puteți reda chiar acum.
<!-- 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>Aceasta este toată integrarea web. Aceeași abordare funcționează și pentru un player propriu, stilizat, schimbați doar URL-ul din feed pentru fiecare meci.
05Asociere automată & feeduri
Linkurile specifice fiecărui meci sunt livrate prin feedul dumneavoastră în JSON sau XML, după preferință. Exemplu de structură JSON:
[
{
"ID": "xxxxx",
"Home": "xxxx",
"Away": "xxxx",
"Time": "xx:xx:xx",
"Date": "xxxx-xx-xx",
"Lang": "xx",
"streamhls": "https://xx/playlist.m3u8"
}
]Pentru a activa asocierea automată, trimiteți-ne un feed inițial cu liga, evenimentul, ora, data și ID-ul meciului. Integrăm ID-urile dumneavoastră de meciuri și cluburi și returnăm un feed cu URL-uri directe către comentariul audio live, ceea ce accelerează mult implementarea.
06FAQ
Q1Cât de des ar trebui să preluăm datele despre comentariul audio?
O dată pe oră este mai mult decât suficient în majoritatea cazurilor. Feedul nu este un CDN propriu-zis, așa că vă rugăm să nu îl interogați mai des de o dată pe minut. Linkurile meciurilor sunt disponibile de obicei cu cel puțin o săptămână înainte, adesea chiar cu o lună. Deoarece orele meciurilor se pot schimba, recomandăm o verificare la fiecare 30 până la 60 de minute.
Q2Cu cât timp înainte de fluierul de start sunt furnizate URL-urile comentariului audio?
Linkurile meciurilor sunt disponibile de regulă cu până la o lună înainte de fluierul de start. Pentru meciurile alese individual, fereastra obișnuită este de aproximativ 48 de ore înainte, sau mai devreme, prin înțelegere, pentru semifinale, finale și alte partide importante. O putem adapta nevoilor dumneavoastră.
Q3Când începe comentariul audio?
Transmisiunea live începe de regulă cu 5 minute înainte de fluierul de start și rămâne activă până la 5 minute după fluierul final. URL-urile de stream rămân active permanent; în afara comentariului live rulează o buclă automată, care poate purta sunetul brandului dumneavoastră. La pauză redăm o buclă (în prezent, atmosferă de stadion), care poate fi și ea înlocuită cu audio propriu, dacă ne trimiteți materialele. Vă ajutăm cu plăcere să construiți o buclă cu brandingul dumneavoastră.
Q4Când primim datele de producție cu URL-urile reale ale comentariului audio?
URL-urile de test pe care le furnizăm sunt deja complet funcționale, practic linkuri la nivel de producție. Singurele diferențe: nu poartă încă brandingul dumneavoastră, nu sunt conectate la sistemul nostru de statistici și soluția de rezervă prin CDN nu este activată. Sunt dimensionate pentru aproximativ 1.000 de utilizatori simultani, pentru testare, dar reflectă exact cum vor arăta URL-urile finale de producție.
Q5Datele de producție vor necesita autentificare?
Da. Feedurile de producție sunt securizate printr-o listă de adrese IP permise. Trimiteți-ne lista adreselor IP pe care doriți să le autorizați și activăm accesul pentru ele atunci când furnizăm URL-urile finale de producție.
Să aducem audio sportiv live pe platforma dumneavoastră.
Spuneți-ne ce construiți și vom găsi împreună soluția potrivită.