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.
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.
Pola feedu
| Pole | Opis |
|---|---|
matchId | Unikalny identyfikator meczu. Stałe ID, które nigdy się nie zmienia dla danego wydarzenia. |
leagueId | Identyfikator ligi / rozgrywek (EnetpulseID). |
homeId | Identyfikator drużyny gospodarzy (EnetpulseID). |
awayId | Identyfikator drużyny gości (EnetpulseID). |
leagueName | Nazwa ligi / rozgrywek. |
homeName | Nazwa drużyny gospodarzy. |
awayName | Nazwa drużyny gości. |
matchDate | Data i godzina meczu, format Y-m-d H:i:s, UTC. |
streamhls | Adres streamu HLS. |
lang | Kod języka komentarza. |
country | Kod 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ć.
03Zalecane odtwarzacze & SDK
Web
Odtwarzacz oparty na hls.js z instrukcją konfiguracji:
- Przewodnik wdrożeniowy (web): sportsradio.cz/implementationguide.html
Android
Polecamy ExoPlayer, choć zadziała każdy odtwarzacz z obsługą HLS. Udostępniamy też własne SDK oparte na ExoPlayerze.
- ExoPlayer: github.com/google/ExoPlayer
- Odtwarzacz GBVision na Androida (ZIP): pobierz tutaj
- Dostęp do GitLaba: skontaktuj się z nami, aby poprosić o repozytorium.
iOS
Użyj natywnego odtwarzacza Apple (obsługuje HLS) lub naszego własnego SDK na iOS.
- Odtwarzacz GBVision na iOS: github.com/alvitres01/gb_vision_player_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.
<!-- 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.
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.