Tecnologia
MANUAL DE INTEGRAÇÃO

Implantação da narração em áudio

Este guia cobre tudo o que você precisa para implantar a nossa narração em áudio ao vivo na sua plataforma: o formato de streaming, o feed de produção, os players recomendados para web, iOS e Android, o pareamento automático e as respostas para as dúvidas de integração mais comuns.

01Visão geral do streaming

Nossa narração em áudio ao vivo é entregue como streams HLS padrão, no formato seguro, universal e multiplataforma. Qualquer player compatível com HLS funciona sem ajustes. Para a web, recomendamos um player baseado em hls.js, que é gratuito e pode ser incorporado a qualquer página HTML.

FormatoHLS
CodecAAC
Taxa de bits64, 96, 128 kbps
CanaisMono
PlataformasWeb · iOS · Android

A integração é simples: leia o feed de produção, selecione a partida desejada e passe a URL do stream para o seu player. Sem protocolo proprietário, sem dependência de player.

02Feed de produção

O seu feed de produção fica em um endpoint permanente. Só o conteúdo é atualizado, a URL nunca muda, então você pode deixá-la fixa do seu lado.

https://sportsradio.cz/testfeed.php

Campos do feed

CampoDescrição
matchIdIdentificador único da partida. ID estável, que nunca muda para um determinado evento.
leagueIdIdentificador da liga / competição (EnetpulseID).
homeIdIdentificador do time mandante (EnetpulseID).
awayIdIdentificador do time visitante (EnetpulseID).
leagueNameNome da liga / competição.
homeNameNome do time mandante.
awayNameNome do time visitante.
matchDateData e hora da partida, formato Y-m-d H:i:s, UTC.
streamhlsURL do stream HLS.
langCódigo do idioma da narração.
countryCódigo do país / da região. Usamos int para competições internacionais.

A estrutura do feed pode ser totalmente personalizada de acordo com os seus requisitos. Precisa de campos extras, de um ID de cliente ou de feeds por idioma? É só nos avisar.

Observação: a URL do feed de produção é permanente, mas os links de stream que estão nele agora servem apenas para testes. Eles são substituídos por links reais de produção quando você entra no ar.

03Players & SDKs recomendados

Web

Um player baseado em hls.js com instruções de configuração:

Android

Recomendamos o ExoPlayer, embora qualquer player com suporte a HLS funcione. Também oferecemos o nosso próprio SDK baseado no ExoPlayer.

iOS

Use o player nativo da Apple (com suporte a HLS) ou o nosso próprio SDK para iOS.

04Implementação na web (hls.js)

Um trecho de código mínimo, pronto para produção. Carregue o hls.js, aponte-o para a URL streamhls do feed e conecte-o a um elemento de áudio. Abaixo há um stream de teste ao vivo que você pode reproduzir agora mesmo.

Stream de teste ao vivo
Pronto · aperte o 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>

Essa é toda a integração na web. A mesma abordagem serve para um player próprio estilizado, basta trocar a URL do feed a cada partida.

05Pareamento automático & feeds

Os links específicos de cada partida são entregues pelo seu feed em JSON ou XML, como você preferir. Exemplo de estrutura JSON:

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

Para ativar o pareamento automático, envie para nós um feed inicial com liga, evento, horário, data e ID da partida. Integramos os seus IDs de partida e de clube e devolvemos um feed com as URLs diretas da narração em áudio ao vivo, o que acelera muito a implantação.

Stream de teste: os links do feed de exemplo não estão ativos. Para testar, use o stream contínuo ao vivo: livesportradio.com/global/livescore/playlist.m3u8

06FAQ

Q1Com que frequência devemos buscar os dados da narração em áudio?

Uma vez por hora é mais que suficiente na maioria dos casos. O feed não é uma CDN completa, então evite consultá-lo mais de uma vez por minuto. Os links das partidas costumam estar disponíveis com pelo menos uma semana de antecedência, muitas vezes até um mês. Como os horários podem mudar, o recomendado é verificar a cada 30 a 60 minutos.

Q2Com quanta antecedência do início as URLs da narração em áudio são fornecidas?

Os links das partidas costumam estar disponíveis até um mês antes do início. Para partidas escolhidas a dedo, a janela usual é de cerca de 48 horas antes, ou mais cedo mediante combinação para semifinais, finais e outros jogos importantes. Podemos ajustar isso às suas necessidades.

Q3Quando a narração em áudio começa?

A transmissão ao vivo geralmente começa 5 minutos antes do início e fica ativa até 5 minutos depois do apito final. As URLs de stream permanecem ativas o tempo todo; fora da narração ao vivo toca um loop automático, que pode levar o áudio da sua marca. No intervalo tocamos um loop (atualmente, som ambiente de estádio), que também pode ser substituído por áudio personalizado se você nos enviar o material. Teremos prazer em ajudar a criar um loop com a sua marca.

Q4Quando recebemos os dados de produção com as URLs reais da narração em áudio?

As URLs de teste que fornecemos já são totalmente funcionais, basicamente links de nível de produção. As únicas diferenças: ainda não levam a sua marca, não estão conectadas ao nosso sistema de estatísticas e o fallback de CDN não está ativado. Elas são dimensionadas para cerca de 1.000 usuários simultâneos em testes, mas refletem exatamente como serão as suas URLs finais de produção.

Q5Os dados de produção vão exigir autenticação?

Sim. Os feeds de produção são protegidos por lista de IPs permitidos. Envie para nós a lista de endereços IP que você quer autorizar e liberamos o acesso para esses IPs quando fornecermos as URLs finais de produção.

Vamos levar o áudio esportivo ao vivo para a sua plataforma.

Conte para nós o que você está construindo e vamos encontrar juntos a solução certa.

Solicitar uma demo