Technologie
INTEGRAČNÍ MANUÁL

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.

FormátHLS
KodekAAC
Datový tok64, 96, 128 kbps
KanályMono
PlatformyWeb · iOS · Android

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.

https://sportsradio.cz/testfeed.php

Pole feedu

PolePopis
matchIdJedinečný identifikátor zápasu. Stabilní ID, které se u dané události nikdy nemění.
leagueIdIdentifikátor ligy / soutěže (EnetpulseID).
homeIdIdentifikátor domácího týmu (EnetpulseID).
awayIdIdentifikátor hostujícího týmu (EnetpulseID).
leagueNameNázev ligy / soutěže.
homeNameNázev domácího týmu.
awayNameNázev hostujícího týmu.
matchDateDatum a čas zápasu, formát Y-m-d H:i:s, UTC.
streamhlsAdresa HLS streamu.
langKód jazyka komentáře.
countryKó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.

Poznámka: adresa produkčního feedu je stálá, ale odkazy na streamy, které v něm teď jsou, slouží jen k testování. Při ostrém spuštění je nahradíme živými produkčními odkazy.

03Doporučené přehrávače & SDK

Web

Přehrávač postavený na hls.js s návodem k nastavení:

Android

Doporučujeme ExoPlayer, funguje ale jakýkoli přehrávač s podporou HLS. Dodáváme i vlastní SDK postavené na ExoPlayeru.

iOS

Použijte nativní přehrávač Apple (podporuje HLS) nebo naše vlastní iOS SDK.

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.

Živý testovací stream
Připraveno · stiskněte přehrát
<!-- 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í.

Testovací stream: odkazy v ukázkovém feedu nejsou aktivní. K testování použijte nepřetržitý živý stream: livesportradio.com/global/livescore/playlist.m3u8

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

Vyžádat demo