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.
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.
Campi del feed
| Campo | Descrizione |
|---|---|
matchId | Identificativo univoco della partita. ID stabile, che non cambia mai per un dato evento. |
leagueId | Identificativo della lega / competizione (EnetpulseID). |
homeId | Identificativo della squadra di casa (EnetpulseID). |
awayId | Identificativo della squadra ospite (EnetpulseID). |
leagueName | Nome della lega / competizione. |
homeName | Nome della squadra di casa. |
awayName | Nome della squadra ospite. |
matchDate | Data e ora della partita, formato Y-m-d H:i:s, UTC. |
streamhls | URL dello stream HLS. |
lang | Codice della lingua del commento. |
country | Codice 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.
03Player & SDK consigliati
Web
Un player basato su hls.js con istruzioni di configurazione:
- Guida all'implementazione (web): sportsradio.cz/implementationguide.html
Android
Consigliamo ExoPlayer, ma funziona qualsiasi player con supporto HLS. Forniamo anche un nostro SDK basato su ExoPlayer.
- ExoPlayer: github.com/google/ExoPlayer
- Player GBVision per Android (ZIP): scarica qui
- Accesso a GitLab: contattateci per richiedere il repository.
iOS
Usate il player nativo di Apple (HLS supportato) oppure il nostro SDK per iOS.
- Player GBVision per iOS: github.com/alvitres01/gb_vision_player_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.
<!-- 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.
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.