Recursos avançados da web rádio: o que está no seu plano e como usar

Recursos avançados: o que está no seu plano

O painel da rádio é uma plataforma completa e mostra opções que não fazem parte do serviço contratado. Esta tabela separa o que você usa pelo painel, o que depende de algo fora dele e o que não está disponível, mesmo quando aparece na tela.

Os itens fora do serviço aparecem na tela porque a plataforma é completa, mas não estão no seu acesso ou podem reiniciar a rádio: deixe-os como estão. Pular a música, desconectar um locutor à força e reiniciar a transmissão ficam com a equipe: peça pela central do cliente.

Limites de cada plano

O limite de ouvintes vale para a soma dos pontos de montagem: num plano de 200 ouvintes, 150 no MP3 e 50 no AAC já ocupam tudo. A qualidade máxima vale para cada ponto. Para mais ouvintes, mais qualidade ou mais espaço, a troca de plano é feita pela central do cliente.

Pontos de montagem: MP3 e AAC na mesma rádio

Cada ponto de montagem é um endereço de escuta com um formato e uma qualidade. A rádio já vem com um em MP3 (/radio.mp3). O segundo costuma ser um AAC de qualidade menor, que soa bem e gasta menos dados no celular. Os dois tocam a mesma programação ao mesmo tempo (veja Formatos).

1. Abra os pontos de montagem

   No painel: Transmissão›Ponto de Montagem(em inglês: Broadcasting › Mount Points)

   A lista mostra o /radio.mp3, marcado como Montagem Padrão (Default Mount). Ele é o que o player público toca.

2. Crie o segundo ponto

   Clique em Adicionar Ponto de Montagem (Add Mount Point). Na aba Informações básicas (Basic Info):

   Campo	O que preencher
   URL do Ponto de Montagem	/radio.aacSempre começa com barra e vira o final do endereço de escuta.
   Exibir Nome	Opcional (ex.: AAC 64 kbps)Aparece no seletor do player.
   Mostrar em Páginas Públicas	Marcado
   Definir como o ponto de montagem padrão	DesmarcadoO padrão continua sendo o MP3.
   URL de retransmissão de stream	Em brancoRetransmitir outra rádio não faz parte do serviço.
   Duração Máxima do Ouvinte	0Com 0, o ouvinte fica conectado o tempo que quiser.
   Ponto de Montagem de Contingência	Deixe como está (/error.mp3)

3. Escolha o formato

   Na aba AutoDJ:

   Campo	O que preencher
   Habilitar AutoDJ	MarcadoSem isso, o ponto fica sem a programação do AutoDJ.
   Formato do AutoDJ	AAC+ (MPEG4 HE-AAC v2)
   Taxa de Bits do AutoDJ (kbps)	64A lista só mostra valores até o máximo do seu plano.

4. Não mexa nas abas Introdução e Avançado

   A Introdução (Intro) exige um arquivo exatamente no formato e na qualidade do ponto, e o Avançado tem a "Configuração Avançada do Frontend", que mexe no servidor de streaming. Deixe as duas como estão.

5. Salve e peça para aplicar

   Salve. O ponto novo só começa a transmitir depois que a transmissão é reiniciada, o que a equipe faz: abra um chamado dizendo que criou o ponto /radio.aac.

6. Teste o endereço novo

   Depois do reinício, a Visão Geral mostra os dois pontos em Transmissões. Teste no celular https://radio.example.com/listen/minha-radio/radio.aac, com o endereço e o nome da sua rádio.

Mantenha o MP3 como padrão, por ser o mais compatível, e use o AAC+ no segundo ponto: ele soa bem em qualidades baixas. Evite OGG Vorbis e OGG Opus (não tocam no Safari do iPhone, e o Opus não envia o nome da música) e FLAC (gasta muita banda e também não envia o nome da música).

Gravação das transmissões ao vivo

O painel grava cada programa ao vivo num arquivo, para reprises, redes sociais ou arquivo da rádio. Grava só o que entra pelos locutores, não o AutoDJ. Veja Gravação dos programas ao vivo.

1. Em Editar Perfil da Estação, aba Streamers/DJs, marque Gravar Transmissões Ao Vivo e escolha o formato (MP3, OGG Vorbis, OGG Opus ou AAC+; o MP3 é o mais prático) e a taxa de bits. Salve e abra um chamado: a gravação vale depois do reinício feito pela equipe.
2. Depois do programa, em Transmissão Ao Vivo › Contas de Streamer/DJ, o botão Transmissão (Broadcasts) do locutor lista as gravações, com Download e Excluir.
3. Baixe o que quiser guardar e apague as antigas: com o espaço de gravações cheio, os próximos programas podem não ser gravados.

API pública: tocando agora, ouvintes e histórico

A API pública entrega, em JSON, o que está tocando, o que vem a seguir, as últimas músicas, os ouvintes e se há locutor ao vivo. Não precisa de chave e aceita chamadas de qualquer site (CORS liberado). As respostas ficam em cache por 15 segundos: consultar mais vezes não traz dados mais novos.

https://radio.example.com/api/nowplaying/minha-radio

<p>Tocando agora: <span id="tocando"></span></p>
<p>Ouvintes: <span id="ouvintes"></span></p>
<p id="ao-vivo" hidden>Estamos ao vivo!</p>

<script>
  const ENDERECO = "https://radio.example.com/api/nowplaying/minha-radio";

  async function atualizar() {
    try {
      const resposta = await fetch(ENDERECO);
      if (!resposta.ok) return;
      const dados = await resposta.json();
      const musica = dados.now_playing && dados.now_playing.song;
      if (musica) {
        document.getElementById("tocando").textContent = [musica.artist, musica.title].filter(Boolean).join(" - ");
      }
      document.getElementById("ouvintes").textContent = dados.listeners ? dados.listeners.total : "";
      document.getElementById("ao-vivo").hidden = !(dados.live && dados.live.is_live);
    } catch (erro) {
      // Sem internet ou rádio fora do ar: tenta de novo na próxima volta.
    }
  }

  atualizar();
  setInterval(atualizar, 30000);
</script>

• Escreva os dados com textContent, como no exemplo, e não monte HTML com eles: o título vem do arquivo e pode ter qualquer caractere.
• O tempo decorrido e o restante podem vir defasados pelo cache: para uma barra de progresso, calcule a partir de played_at.
• A API depende das páginas públicas ligadas (ou de Ativar APIs públicas, no perfil). Ela não traz dados dos ouvintes, como endereços IP.

Widgets, página pública, agenda e listas M3U e PLS

Na Visão Geral, o quadro Páginas Públicas tem o botão Incorporar Widgets (Embed Widgets), que abre o Construtor de Widgets de Incorporação de Player. Nele você escolhe o Tipo de Widget (Player, Histórico, Podcasts ou Agendamento), o Tema, as cores, o estilo de layout e os controles, vê a Visualização Ao Vivo e copia o Código para Incorporar. Para montar o código do player com mais opções, use também o gerador de player.

• Tema: escolha Claro ou Escuro. Navegador Padrão não segue o tema do aparelho do visitante: usa o tema padrão do painel.
• Reprodução Automática: o código gerado não pede permissão de tocar sozinho, e os navegadores bloqueiam som automático antes do primeiro clique. Conte com o clique no play.
• Página pública: https://radio.example.com/public/minha-radio (o player sozinho fica no final /embed). Agenda pública: o mesmo endereço com /schedule.
• M3U e PLS: arquivos que abrem a rádio direto em players como o VLC (gratuito). Baixe em Visão Geral › Transmissões (Baixar M3U e Baixar PLS) ou divulgue https://radio.example.com/public/minha-radio/playlist.m3u (ou .pls).

Grupos de playlist: a programação em forma de relógio

Um Grupo de Playlist (Playlist Group) é uma playlist feita de outras playlists, tocadas em sequência. É o "relógio" das rádios: duas músicas da Sucessos, uma da Novidades, uma vinheta, e de novo. O grupo tem tipo, peso e agenda como qualquer playlist.

1. Prepare as playlists membros

   Crie e preencha as playlists (ex.: Sucessos, Novidades e Vinhetas do relógio).

2. Crie o grupo

   No painel: Playlists

   Clique em Adicionar Playlist (Add Playlist) e preencha:

   Campo	O que preencher
   Nome da Playlist	Ex.: Relógio da manhã
   Fonte	Grupo de Playlist
   Ordem de Reprodução da Música	SequencialPara as playlists membros tocarem na ordem que você definir.
   Tipo de Playlist e agenda	Como numa playlist comumEx.: Rotação Geral, com horário das 6h às 10h na aba Agendamento.

3. Coloque as playlists no grupo

   Abra a aba Agrupamento de Playlists (Playlist Grouping) e clique no grupo, na coluna Playlists: o Conteúdo da Playlist aparece ao lado. Nas outras playlists, use o botão Adicionar ao grupo de playlist selecionado e ajuste a ordem com Mover para Cima e Mover para Baixo.

4. Defina quantas músicas de cada uma

   Campo	O que preencher
   Reproduções Consecutivas	Quantas músicas seguidas daquela playlist antes de passar para a próxima (ex.: 2 em Sucessos)Com 0, toca uma.
   Reproduzir completamente antes de avançar	OpcionalToca a playlist inteira antes de passar para a próxima. Aparece para playlists de músicas com ordem Sequencial ou Embaralhado.

5. Confira no ar

   Acompanhe a sequência na Linha do Tempo da Reprodução (em Relatórios) e no "A Seguir" da Visão Geral. Na edição de uma playlist, a aba Associações mostra de quais grupos ela participa.

Playlist de URL remota: tocar outra transmissão

Ao criar uma playlist, a Fonte também oferece URL Remoto (Remote URL). Uma Playlist de URL Remota toca, no horário dela, o áudio de outro endereço: uma transmissão Icecast ou Shoutcast, uma playlist M3U ou PLS publicada na internet ou um arquivo. Serve, por exemplo, para entrar em cadeia com o programa de uma rádio parceira.

• Tenha autorização de quem produz o conteúdo: retransmitir outra rádio sem permissão viola direitos autorais (Lei 9.610/1998).
• Você depende da fonte: se o endereço externo cair ou mudar, a sua rádio fica sem aquele conteúdo no horário. A equipe não controla servidores de terceiros.
• Teste antes num horário de pouca audiência. O Buffer da Reprodução Remota (Segundos) guarda alguns segundos do áudio externo: valores muito curtos causam cortes.