Technologie
MANUEL D'INTÉGRATION

Déploiement du commentaire audio

Ce guide couvre tout ce dont vous avez besoin pour déployer notre commentaire audio en direct sur votre plateforme : le format de streaming, le flux de production, les lecteurs recommandés pour le web, iOS et Android, l'appariement automatique et les réponses aux questions d'intégration les plus fréquentes.

01Aperçu du streaming

Notre commentaire audio en direct est diffusé sous forme de flux HLS standard, dans le format sécurisé, universel et multiplateforme. Tout lecteur compatible HLS fonctionne tel quel. Pour le web, nous recommandons un lecteur basé sur hls.js, gratuit et intégrable dans n'importe quelle page HTML.

FormatHLS
CodecAAC
Débit64, 96, 128 kbps
CanauxMono
PlateformesWeb · iOS · Android

L'intégration est simple : lisez le flux de production, sélectionnez le match souhaité et transmettez l'URL du flux à votre lecteur. Aucun protocole propriétaire, aucune dépendance à un lecteur.

02Flux de production

Votre flux de production se trouve sur un point d'accès permanent. Seul le contenu est mis à jour, l'URL ne change jamais, vous pouvez donc la coder en dur de votre côté.

https://sportsradio.cz/testfeed.php

Champs du flux

ChampDescription
matchIdIdentifiant unique du match. ID stable, qui ne change jamais pour un événement donné.
leagueIdIdentifiant de la ligue / compétition (EnetpulseID).
homeIdIdentifiant de l'équipe à domicile (EnetpulseID).
awayIdIdentifiant de l'équipe à l'extérieur (EnetpulseID).
leagueNameNom de la ligue / compétition.
homeNameNom de l'équipe à domicile.
awayNameNom de l'équipe à l'extérieur.
matchDateDate et heure du match, format Y-m-d H:i:s, UTC.
streamhlsURL du flux HLS.
langCode de la langue du commentaire.
countryCode du pays / de la région. Nous utilisons int pour les compétitions internationales.

La structure du flux peut être entièrement personnalisée selon vos exigences. Besoin de champs supplémentaires, d'un identifiant client ou de flux par langue ? Dites-le-nous simplement.

Remarque : l'URL du flux de production est permanente, mais les liens de flux qu'il contient actuellement servent uniquement aux tests. Ils sont remplacés par de vrais liens de production lors de votre mise en service.

03Lecteurs & SDK recommandés

Web

Un lecteur basé sur hls.js avec des instructions de mise en place :

Android

Nous recommandons ExoPlayer, mais tout lecteur compatible HLS fonctionne. Nous fournissons aussi notre propre SDK basé sur ExoPlayer.

iOS

Utilisez le lecteur natif d'Apple (compatible HLS) ou notre propre SDK iOS.

04Implémentation web (hls.js)

Un extrait de code minimal, prêt pour la production. Chargez hls.js, pointez-le vers l'URL streamhls du flux et rattachez-le à un élément audio. Vous trouverez ci-dessous un flux de test en direct que vous pouvez lire dès maintenant.

Flux de test en direct
Prêt · appuyez sur lecture
<!-- 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>

C'est toute l'intégration web. La même approche vaut pour un lecteur personnalisé à votre charte, il suffit de changer l'URL pour chaque match à partir du flux.

05Appariement automatique & flux

Les liens propres à chaque match sont livrés via votre flux en JSON ou XML, selon votre préférence. Exemple de structure JSON :

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

Pour activer l'appariement automatique, envoyez-nous un flux initial avec la ligue, l'événement, l'heure, la date et l'identifiant du match. Nous intégrons vos identifiants de matchs et de clubs et renvoyons un flux avec les URL directes du commentaire audio en direct, ce qui accélère nettement le déploiement.

Flux de test : les liens du flux d'exemple ne sont pas actifs. Pour vos tests, utilisez le flux continu en direct : livesportradio.com/global/livescore/playlist.m3u8

06FAQ

Q1À quelle fréquence devons-nous récupérer les données du commentaire audio ?

Une fois par heure suffit largement dans la plupart des cas. Le flux n'est pas un CDN à part entière, merci donc d'éviter de l'interroger plus d'une fois par minute. Les liens de match sont généralement disponibles au moins une semaine à l'avance, souvent jusqu'à un mois. Comme les horaires peuvent changer, une vérification toutes les 30 à 60 minutes est l'approche recommandée.

Q2Combien de temps avant le coup d'envoi les URL du commentaire audio sont-elles fournies ?

Les liens de match sont généralement disponibles jusqu'à un mois avant le coup d'envoi. Pour les matchs choisis à la main, la fenêtre habituelle est d'environ 48 heures avant, ou plus tôt sur accord pour les demi-finales, les finales et d'autres rencontres clés. Nous pouvons l'ajuster à vos besoins.

Q3Quand le commentaire audio commence-t-il ?

La diffusion en direct commence généralement 5 minutes avant le coup d'envoi et reste active jusqu'à 5 minutes après le coup de sifflet final. Les URL de flux restent actives en continu ; en dehors du commentaire en direct, une boucle automatique est diffusée et peut porter l'audio de votre marque. À la mi-temps, nous diffusons une boucle (actuellement une ambiance de stade), elle aussi remplaçable par un audio personnalisé si vous nous envoyez les éléments. Nous vous aidons volontiers à créer une boucle à vos couleurs.

Q4Quand recevons-nous les données de production avec les vraies URL du commentaire audio ?

Les URL de test que nous fournissons sont déjà pleinement fonctionnelles, quasiment des liens de niveau production. Les seules différences : elles ne portent pas encore votre habillage, ne sont pas reliées à notre système de statistiques et le secours CDN n'est pas activé. Elles sont dimensionnées pour environ 1 000 utilisateurs simultanés pour les tests, mais reflètent exactement ce que seront vos URL de production définitives.

Q5Les données de production nécessiteront-elles une authentification ?

Oui. Les flux de production sont sécurisés par une liste blanche d'adresses IP. Envoyez-nous la liste des adresses IP que vous souhaitez autoriser et nous activerons l'accès pour celles-ci lorsque nous fournirons les URL de production définitives.

Apportons l'audio sportif en direct à votre plateforme.

Dites-nous ce que vous construisez et nous trouverons ensemble la bonne solution.

Demander une démo