Tehnologie
MANUAL DE INTEGRARE

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.

FormatHLS
CodecAAC
Rată de biți64, 96, 128 kbps
CanaleMono
PlatformeWeb · iOS · Android

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ă.

https://sportsradio.cz/testfeed.php

Câmpurile feedului

CâmpDescriere
matchIdIdentificator unic al meciului. ID stabil, care nu se schimbă niciodată pentru un anumit eveniment.
leagueIdIdentificatorul ligii / competiției (EnetpulseID).
homeIdIdentificatorul echipei gazdă (EnetpulseID).
awayIdIdentificatorul echipei oaspete (EnetpulseID).
leagueNameNumele ligii / competiției.
homeNameNumele echipei gazdă.
awayNameNumele echipei oaspete.
matchDateData și ora meciului, format Y-m-d H:i:s, UTC.
streamhlsURL-ul streamului HLS.
langCodul limbii comentariului.
countryCodul ță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.

Notă: URL-ul feedului de producție este permanent, dar linkurile de stream aflate acum în el sunt doar pentru testare. Ele sunt înlocuite cu linkuri reale de producție atunci când intrați în producție.

03Playere & SDK-uri recomandate

Web

Un player bazat pe hls.js, cu instrucțiuni de configurare:

Android

Recomandăm ExoPlayer, deși funcționează orice player cu suport HLS. Oferim și propriul nostru SDK bazat pe ExoPlayer.

iOS

Folosiți playerul nativ Apple (cu suport HLS) sau propriul nostru SDK pentru 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.

Stream de test live
Gata · apăsați play
<!-- 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.

Stream de test: linkurile din feedul de exemplu nu sunt active. Pentru testare, folosiți streamul live continuu: livesportradio.com/global/livescore/playlist.m3u8

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ă.

Solicitați un demo