Tecnología
MANUAL DE INTEGRACIÓN

Despliegue del comentario de audio

Esta guía cubre todo lo que necesita para desplegar nuestro comentario de audio en directo en su plataforma: el formato de streaming, el feed de producción, los reproductores recomendados para web, iOS y Android, el emparejamiento automático y las respuestas a las preguntas de integración más habituales.

01Resumen del streaming

Nuestro comentario de audio en directo se entrega como streams HLS estándar en el formato seguro, universal y multiplataforma. Cualquier reproductor compatible con HLS funciona sin cambios. Para la web recomendamos un reproductor basado en hls.js, que es gratuito y se integra en cualquier página HTML.

FormatoHLS
CódecAAC
Tasa de bits64, 96, 128 kbps
CanalesMono
PlataformasWeb · iOS · Android

La integración es sencilla: lea el feed de producción, seleccione el partido que desea y pase la URL del stream a su reproductor. Sin protocolo propietario, sin dependencia de un reproductor.

02Feed de producción

Su feed de producción vive en un endpoint permanente. Solo se actualiza el contenido, la URL nunca cambia, así que puede dejarla fija en su lado.

https://sportsradio.cz/testfeed.php

Campos del feed

CampoDescripción
matchIdIdentificador único del partido. ID estable que nunca cambia para un evento determinado.
leagueIdIdentificador de la liga / competición (EnetpulseID).
homeIdIdentificador del equipo local (EnetpulseID).
awayIdIdentificador del equipo visitante (EnetpulseID).
leagueNameNombre de la liga / competición.
homeNameNombre del equipo local.
awayNameNombre del equipo visitante.
matchDateFecha y hora del partido, formato Y-m-d H:i:s, UTC.
streamhlsURL del stream HLS.
langCódigo del idioma del comentario.
countryCódigo de país / región. Usamos int para las competiciones internacionales.

La estructura del feed se puede personalizar por completo según sus requisitos. ¿Necesita campos adicionales, un ID de cliente o feeds por idioma? Solo tiene que decírnoslo.

Nota: la URL del feed de producción es permanente, pero los enlaces de stream que contiene ahora son solo de prueba. Se sustituyen por enlaces de producción reales cuando usted sale en directo.

03Reproductores & SDK recomendados

Web

Un reproductor basado en hls.js con instrucciones de configuración:

Android

Recomendamos ExoPlayer, aunque funciona cualquier reproductor compatible con HLS. También ofrecemos nuestro propio SDK basado en ExoPlayer.

iOS

Use el reproductor nativo de Apple (compatible con HLS) o nuestro propio SDK para iOS.

04Implementación web (hls.js)

Un fragmento mínimo y listo para producción. Cargue hls.js, apúntelo a la URL streamhls del feed y asócielo a un elemento de audio. Abajo tiene un stream de prueba en directo que puede reproducir ahora mismo.

Stream de prueba en directo
Listo · pulse reproducir
<!-- 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>

Esa es toda la integración web. El mismo enfoque sirve para un reproductor propio con estilos, solo hay que cambiar la URL del feed en cada partido.

05Emparejamiento automático & feeds

Los enlaces de cada partido se entregan a través de su feed en JSON o XML, lo que usted prefiera. Ejemplo de estructura JSON:

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

Para activar el emparejamiento automático, envíenos un feed inicial con liga, evento, hora, fecha e ID de partido. Integramos sus ID de partido y de club y devolvemos un feed con las URL directas del comentario de audio en directo, lo que acelera mucho el despliegue.

Stream de prueba: los enlaces del feed de ejemplo no están activos. Para las pruebas, use el stream continuo en directo: livesportradio.com/global/livescore/playlist.m3u8

06FAQ

Q1¿Con qué frecuencia debemos consultar los datos del comentario de audio?

Una vez por hora es más que suficiente en la mayoría de los casos. El feed no es una CDN completa, así que evite consultarlo más de una vez por minuto. Los enlaces de los partidos suelen estar disponibles al menos una semana antes, a menudo hasta un mes. Como los horarios pueden cambiar, lo recomendable es comprobarlo cada 30 a 60 minutos.

Q2¿Con cuánta antelación al inicio se facilitan las URL del comentario de audio?

Los enlaces de los partidos suelen estar disponibles hasta un mes antes del inicio. Para partidos elegidos a mano, la ventana habitual es de unas 48 horas antes, o antes de mutuo acuerdo para semifinales, finales y otros encuentros clave. Podemos ajustarlo a sus necesidades.

Q3¿Cuándo empieza el comentario de audio?

La emisión en directo suele empezar 5 minutos antes del inicio y permanece activa hasta 5 minutos después del pitido final. Las URL de stream siguen activas de forma continua; fuera del comentario en directo suena un bucle automático, que puede llevar el audio de su marca. En el descanso reproducimos un bucle (ahora mismo, sonido ambiente de estadio), que también se puede sustituir por audio propio si nos envía el material. Estaremos encantados de ayudarle a crear un bucle con su marca.

Q4¿Cuándo recibimos los datos de producción con las URL reales del comentario de audio?

Las URL de prueba que facilitamos ya son plenamente funcionales, prácticamente enlaces de nivel de producción. Las únicas diferencias: aún no llevan su marca, no están conectadas a nuestro sistema de estadísticas y el respaldo de CDN no está activado. Están dimensionadas para unos 1.000 usuarios simultáneos para pruebas, pero reflejan exactamente cómo serán sus URL de producción definitivas.

Q5¿Los datos de producción requerirán autenticación?

Sí. Los feeds de producción están protegidos mediante una lista blanca de IP. Envíenos la lista de direcciones IP que desea autorizar y activaremos el acceso para ellas cuando le entreguemos las URL de producción definitivas.

Llevemos el audio deportivo en directo a su plataforma.

Cuéntenos qué está construyendo y exploraremos juntos la solución adecuada.

Solicitar una demo