Technologia
INSTRUKCJA INTEGRACJI

Wdrożenie komentarza audio

Ten przewodnik obejmuje wszystko, czego potrzebujesz, aby wdrożyć nasz komentarz audio na żywo na swojej platformie: format streamingu, feed produkcyjny, zalecane odtwarzacze dla przeglądarki, iOS i Androida, automatyczne parowanie oraz odpowiedzi na najczęstsze pytania dotyczące integracji.

01Przegląd streamingu

Nasz komentarz audio na żywo dostarczamy jako standardowe streamy HLS w bezpiecznym, uniwersalnym formacie wieloplatformowym. Każdy odtwarzacz zgodny z HLS działa od ręki. Do przeglądarki polecamy odtwarzacz oparty na hls.js, który jest darmowy i daje się osadzić na dowolnej stronie HTML.

FormatHLS
KodekAAC
Przepływność64, 96, 128 kbps
KanałyMono
PlatformyWeb · iOS · Android

Integracja jest prosta: odczytaj feed produkcyjny, wybierz mecz, którego potrzebujesz, i przekaż adres streamu swojemu odtwarzaczowi. Żadnego własnościowego protokołu, żadnego przywiązania do odtwarzacza.

02Feed produkcyjny

Twój feed produkcyjny działa pod stałym endpointem. Zmienia się tylko zawartość, adres nigdy, więc możesz wpisać go na stałe po swojej stronie.

https://sportsradio.cz/testfeed.php

Pola feedu

PoleOpis
matchIdUnikalny identyfikator meczu. Stałe ID, które nigdy się nie zmienia dla danego wydarzenia.
leagueIdIdentyfikator ligi / rozgrywek (EnetpulseID).
homeIdIdentyfikator drużyny gospodarzy (EnetpulseID).
awayIdIdentyfikator drużyny gości (EnetpulseID).
leagueNameNazwa ligi / rozgrywek.
homeNameNazwa drużyny gospodarzy.
awayNameNazwa drużyny gości.
matchDateData i godzina meczu, format Y-m-d H:i:s, UTC.
streamhlsAdres streamu HLS.
langKod języka komentarza.
countryKod kraju / regionu. Dla rozgrywek międzynarodowych używamy int.

Strukturę feedu można w pełni dostosować do Twoich wymagań. Potrzebujesz dodatkowych pól, ID klienta lub feedów dla poszczególnych języków? Daj nam znać.

Uwaga: adres feedu produkcyjnego jest stały, ale linki do streamów, które się w nim teraz znajdują, służą wyłącznie do testów. W chwili uruchomienia zastąpimy je produkcyjnymi linkami na żywo.

03Zalecane odtwarzacze & SDK

Web

Odtwarzacz oparty na hls.js z instrukcją konfiguracji:

Android

Polecamy ExoPlayer, choć zadziała każdy odtwarzacz z obsługą HLS. Udostępniamy też własne SDK oparte na ExoPlayerze.

iOS

Użyj natywnego odtwarzacza Apple (obsługuje HLS) lub naszego własnego SDK na iOS.

04Implementacja w przeglądarce (hls.js)

Minimalny fragment kodu gotowy na produkcję. Załaduj hls.js, wskaż mu adres streamhls z feedu i podłącz go do elementu audio. Poniżej znajduje się testowy stream na żywo, który możesz odtworzyć od razu.

Testowy stream na żywo
Gotowe · naciśnij odtwarzanie
<!-- 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 cała integracja w przeglądarce. To samo podejście sprawdza się we własnym, ostylowanym odtwarzaczu, wystarczy podmieniać adres z feedu dla każdego meczu.

05Automatyczne parowanie & feedy

Linki do konkretnych meczów dostarczamy przez Twój feed w JSON lub XML, w zależności od preferencji. Przykładowa struktura JSON:

[
  {
    "ID": "xxxxx",
    "Home": "xxxx",
    "Away": "xxxx",
    "Time": "xx:xx:xx",
    "Date": "xxxx-xx-xx",
    "Lang": "xx",
    "streamhls": "https://xx/playlist.m3u8"
  }
]

Aby włączyć automatyczne parowanie, prześlij nam początkowy feed z ligą, wydarzeniem, godziną, datą i ID meczu. Zintegrujemy Twoje ID meczów i klubów i zwrócimy feed z bezpośrednimi adresami komentarza audio na żywo, co znacznie przyspiesza wdrożenie.

Stream testowy: linki w przykładowym feedzie nie są aktywne. Do testów użyj ciągłego streamu na żywo: livesportradio.com/global/livescore/playlist.m3u8

06FAQ

Q1Jak często powinniśmy pobierać dane komentarza audio?

W większości przypadków raz na godzinę w zupełności wystarczy. Feed nie jest pełnoprawnym CDN, dlatego prosimy nie odpytywać go częściej niż raz na minutę. Linki do meczów są zwykle dostępne co najmniej tydzień wcześniej, często nawet miesiąc. Ponieważ godziny meczów mogą się zmieniać, zalecamy sprawdzanie co 30 do 60 minut.

Q2Na jak długo przed pierwszym gwizdkiem udostępniane są adresy komentarza audio?

Linki do meczów są zwykle dostępne nawet miesiąc przed pierwszym gwizdkiem. Dla meczów wybieranych ręcznie typowe okno to około 48 godzin wcześniej, a po uzgodnieniu wcześniej dla półfinałów, finałów i innych kluczowych spotkań. Możemy dopasować to do Twoich potrzeb.

Q3Kiedy zaczyna się komentarz audio?

Transmisja na żywo zaczyna się zazwyczaj 5 minut przed pierwszym gwizdkiem i pozostaje aktywna do 5 minut po ostatnim gwizdku. Adresy streamów są aktywne bez przerwy; poza komentarzem na żywo gra automatyczna pętla, która może nieść Twój dźwięk brandingowy. W przerwie meczu odtwarzamy pętlę (obecnie odgłosy stadionu), którą także można zastąpić własnym dźwiękiem, jeśli prześlesz nam materiały. Chętnie pomożemy przygotować pętlę z Twoim brandingiem.

Q4Kiedy otrzymamy dane produkcyjne z prawdziwymi adresami komentarza audio?

Testowe adresy, które udostępniamy, są już w pełni funkcjonalne, w praktyce to linki na poziomie produkcyjnym. Jedyne różnice: nie niosą jeszcze Twojego brandingu, nie są podłączone do naszego systemu statystyk i nie mają włączonego zapasowego CDN. Są przygotowane na około 1 000 jednoczesnych użytkowników na potrzeby testów, ale dokładnie odzwierciedlają to, jak będą wyglądać Twoje docelowe adresy produkcyjne.

Q5Czy dane produkcyjne będą wymagały uwierzytelnienia?

Tak. Feedy produkcyjne są zabezpieczone białą listą adresów IP. Prześlij nam listę adresów IP, które chcesz autoryzować, a włączymy dla nich dostęp przy przekazaniu docelowych adresów produkcyjnych.

Wprowadźmy sportowe audio na żywo na Twoją platformę.

Opowiedz nam, nad czym pracujesz, a wspólnie znajdziemy właściwe rozwiązanie.

Zamów demo