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.
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.
Campos do feed
| Campo | Descrição |
|---|---|
matchId | Identificador único da partida. ID estável, que nunca muda para um determinado evento. |
leagueId | Identificador da liga / competição (EnetpulseID). |
homeId | Identificador do time mandante (EnetpulseID). |
awayId | Identificador do time visitante (EnetpulseID). |
leagueName | Nome da liga / competição. |
homeName | Nome do time mandante. |
awayName | Nome do time visitante. |
matchDate | Data e hora da partida, formato Y-m-d H:i:s, UTC. |
streamhls | URL do stream HLS. |
lang | Código do idioma da narração. |
country | Có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.
03Players & SDKs recomendados
Web
Um player baseado em hls.js com instruções de configuração:
- Guia de implementação (web): sportsradio.cz/implementationguide.html
Android
Recomendamos o ExoPlayer, embora qualquer player com suporte a HLS funcione. Também oferecemos o nosso próprio SDK baseado no ExoPlayer.
- ExoPlayer: github.com/google/ExoPlayer
- Player GBVision para Android (ZIP): baixe aqui
- Acesso ao GitLab: fale com a gente para solicitar o repositório.
iOS
Use o player nativo da Apple (com suporte a HLS) ou o nosso próprio SDK para iOS.
- Player GBVision para iOS: github.com/alvitres01/gb_vision_player_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.
<!-- 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.
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.