Tecnologia
MANUALE DI INTEGRAZIONE

Implementazione del commento audio

Questa guida copre tutto ciò che serve per portare il nostro commento audio in diretta sulla vostra piattaforma: il formato di streaming, il feed di produzione, i player consigliati per web, iOS e Android, l'abbinamento automatico e le risposte alle domande di integrazione più comuni.

01Panoramica dello streaming

Il nostro commento audio in diretta viene distribuito come stream HLS standard, nel formato sicuro, universale e multipiattaforma. Qualsiasi player compatibile con HLS funziona senza modifiche. Per il web consigliamo un player basato su hls.js, gratuito e integrabile in qualsiasi pagina HTML.

FormatoHLS
CodecAAC
Bitrate64, 96, 128 kbps
CanaliMono
PiattaformeWeb · iOS · Android

L'integrazione è semplice: leggete il feed di produzione, selezionate la partita che vi interessa e passate l'URL dello stream al vostro player. Nessun protocollo proprietario, nessun vincolo a un player.

02Feed di produzione

Il vostro feed di produzione si trova su un endpoint permanente. Si aggiorna solo il contenuto, l'URL non cambia mai, quindi potete inserirlo in modo fisso dalla vostra parte.

https://sportsradio.cz/testfeed.php

Campi del feed

CampoDescrizione
matchIdIdentificativo univoco della partita. ID stabile, che non cambia mai per un dato evento.
leagueIdIdentificativo della lega / competizione (EnetpulseID).
homeIdIdentificativo della squadra di casa (EnetpulseID).
awayIdIdentificativo della squadra ospite (EnetpulseID).
leagueNameNome della lega / competizione.
homeNameNome della squadra di casa.
awayNameNome della squadra ospite.
matchDateData e ora della partita, formato Y-m-d H:i:s, UTC.
streamhlsURL dello stream HLS.
langCodice della lingua del commento.
countryCodice del paese / della regione. Per le competizioni internazionali usiamo int.

La struttura del feed può essere completamente personalizzata secondo le vostre esigenze. Vi servono campi aggiuntivi, un ID cliente o feed specifici per lingua? Basta farcelo sapere.

Nota: l'URL del feed di produzione è permanente, ma i link agli stream che contiene ora servono solo per i test. Vengono sostituiti con link di produzione reali quando andate live.

03Player & SDK consigliati

Web

Un player basato su hls.js con istruzioni di configurazione:

Android

Consigliamo ExoPlayer, ma funziona qualsiasi player con supporto HLS. Forniamo anche un nostro SDK basato su ExoPlayer.

iOS

Usate il player nativo di Apple (HLS supportato) oppure il nostro SDK per iOS.

04Implementazione web (hls.js)

Uno snippet minimo, pronto per la produzione. Caricate hls.js, puntatelo all'URL streamhls del feed e collegatelo a un elemento audio. Qui sotto trovate uno stream di test live che potete riprodurre subito.

Stream di test live
Pronto · premete 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>

Questa è l'intera integrazione web. Lo stesso approccio vale per un player personalizzato con il vostro stile, basta cambiare l'URL del feed per ogni partita.

05Abbinamento automatico & feed

I link specifici per ogni partita vengono forniti tramite il vostro feed in JSON o XML, come preferite. Esempio di struttura JSON:

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

Per attivare l'abbinamento automatico, inviateci un feed iniziale con lega, evento, ora, data e ID della partita. Integriamo i vostri ID di partite e club e restituiamo un feed con gli URL diretti del commento audio in diretta, il che accelera notevolmente l'implementazione.

Stream di test: i link nel feed di esempio non sono attivi. Per i test usate lo stream live continuo: livesportradio.com/global/livescore/playlist.m3u8

06FAQ

Q1Con quale frequenza dobbiamo recuperare i dati del commento audio?

Una volta all'ora è più che sufficiente nella maggior parte dei casi. Il feed non è una CDN vera e propria, quindi evitate di interrogarlo più di una volta al minuto. I link delle partite sono di solito disponibili almeno una settimana prima, spesso fino a un mese. Poiché gli orari possono cambiare, l'approccio consigliato è un controllo ogni 30-60 minuti.

Q2Quanto tempo prima del calcio d'inizio vengono forniti gli URL del commento audio?

I link delle partite sono in genere disponibili fino a un mese prima del calcio d'inizio. Per le partite scelte una a una la finestra abituale è di circa 48 ore prima, oppure in anticipo previo accordo per semifinali, finali e altri incontri chiave. Possiamo adattarla alle vostre esigenze.

Q3Quando inizia il commento audio?

La trasmissione in diretta inizia in genere 5 minuti prima del calcio d'inizio e resta attiva fino a 5 minuti dopo il fischio finale. Gli URL degli stream restano sempre attivi; al di fuori del commento in diretta viene riprodotto un loop automatico, che può portare l'audio del vostro brand. All'intervallo riproduciamo un loop (al momento, l'atmosfera dello stadio), anch'esso sostituibile con audio personalizzato se ci inviate il materiale. Siamo lieti di aiutarvi a creare un loop con il vostro branding.

Q4Quando riceviamo i dati di produzione con gli URL reali del commento audio?

Gli URL di test che forniamo sono già pienamente funzionanti, in sostanza link di livello produzione. Le uniche differenze: non portano ancora il vostro branding, non sono collegati al nostro sistema di statistiche e il fallback su CDN non è attivo. Sono dimensionati per circa 1.000 utenti simultanei per i test, ma riflettono esattamente come saranno i vostri URL di produzione definitivi.

Q5I dati di produzione richiederanno l'autenticazione?

Sì. I feed di produzione sono protetti tramite whitelist di indirizzi IP. Inviateci l'elenco degli indirizzi IP che volete autorizzare e attiveremo l'accesso per quegli IP quando forniremo gli URL di produzione definitivi.

Portiamo l'audio sportivo in diretta sulla vostra piattaforma.

Raccontateci cosa state costruendo e troveremo insieme la soluzione giusta.

Richiedi una demo