Recursos avançados
Recursos avançados da web rádio: o que está no seu plano e como usar
A tabela do que está no seu plano, como criar o segundo ponto de montagem, a API pública, os widgets, os grupos de playlist e o que não faz parte do serviço.
- Nível: Avançado
- 14 min de leitura
- Atualizado em 31/10/2026
- Por equipe técnica da Hospedagem Segura
Conteúdo do tutorial
Resposta rápida
Estão incluídos no painel: até 2 pontos de montagem (por exemplo, MP3 e AAC), a gravação dos programas ao vivo, a API pública de "tocando agora" (sem chave), os widgets para o site, a página pública com agenda, as listas M3U e PLS e os grupos de playlist. O envio por SFTP e a playlist de URL remota dependem de algo externo. Não fazem parte do serviço: pedidos de música, músicas sob demanda, HLS, podcasts, relays, webhooks, edição do Liquidsoap e acesso aos logs.
Você vai aprender
- Quais recursos avançados estão no seu plano e quais não fazem parte do serviço
- Como criar o segundo ponto de montagem (AAC) dentro do limite do plano
- Como usar a API pública para mostrar a música atual e os ouvintes no seu site
- Onde ficam os widgets, a agenda pública e as listas M3U e PLS
- O básico dos grupos de playlist, novidade da plataforma
Antes de começar
- A rádio no ar, com pelo menos uma playlist de rotação geral (veja AutoDJ e playlists)
- Conhecer o menu do painel (veja O menu da estação)
- Para a API: noções de HTML e JavaScript, ou alguém que cuide do seu site
No painel da sua rádio
Neste tutorial
- Recursos avançados: o que está no seu plano
- Pontos de montagem: MP3 e AAC na mesma rádio
- Gravação das transmissões ao vivo
- API pública: tocando agora, ouvintes e histórico
- Widgets, página pública, agenda e listas M3U e PLS
- Grupos de playlist: a programação em forma de relógio
- Playlist de URL remota: tocar outra transmissão
- Problemas comuns
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.
| Recurso | Situação no seu plano | Observação |
|---|---|---|
| Pontos de montagem (até 2, ex.: MP3 + AAC) | Incluído no painel | Transmissão › Ponto de Montagem; o novo ponto vale depois do reinício feito pela equipe |
| Gravação dos programas ao vivo | Incluído no painel | Liga no perfil, aba Streamers/DJs, e a equipe aplica |
| API pública de "tocando agora" | Incluído no painel | Sem chave, com CORS liberado e até 15 segundos de atraso |
| Widgets (player, histórico, agenda) | Incluído no painel | Visão Geral › Páginas Públicas › Incorporar Widgets |
| Página pública e agenda pública | Incluído no painel | Ligadas desde a entrega |
| Listas M3U e PLS | Incluído no painel | Visão Geral › Transmissões |
| Grupos de playlist | Incluído no painel | Novidade da versão 0.24.0 da plataforma |
| Transmissão ao vivo | Depende de programa ou serviço externo | Programa de transmissão no computador ou Web DJ no navegador |
| Envio por SFTP | Depende de programa ou serviço externo | Mídia › SFTP Usuários, quando aparece, e um programa de SFTP (porta 2022) |
| Playlist de URL remota | Depende de programa ou serviço externo | Depende da fonte externa e da autorização dela |
| Pedidos de música | Não faz parte do serviço | Deixe desligado, mesmo com o botão Habilitar na Visão Geral |
| Músicas sob demanda (on-demand) | Não faz parte do serviço | Exporia o acervo para ouvir e baixar fora da programação |
| HLS | Não faz parte do serviço | Ligar reinicia a rádio na hora |
| Podcasts | Não faz parte do serviço | Ignore o link Podcasts das Páginas Públicas: o recurso não está no seu acesso |
| Retransmissão para outros servidores (relays) | Não faz parte do serviço | Deixe em branco a "URL de retransmissão de stream" dos pontos de montagem |
| Webhooks | Não faz parte do serviço | Para integrar com o seu site, use a API pública |
| Edição do Liquidsoap e playlists do tipo Avançado | Não faz parte do serviço | Uma playlist do tipo Avançado não toca |
| Registros técnicos (logs) | Não faz parte do serviço | A equipe consulta quando atende um chamado |
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.
Pedidos de Músicas, na Visão Geral: deixe desabilitado, mesmo com o botão Habilitar na tela.
Limites de cada plano
| Plano | Ouvintes simultâneos | Qualidade máxima | Espaço para músicas | Espaço para gravações | Pontos de montagem |
|---|---|---|---|---|---|
| Rádio Start | 200 | 128 kbps | 10 GB | 2 GB | 2 |
| Rádio Pro | 500 | 128 kbps | 25 GB | 5 GB | 2 |
| Rádio Max | 1.000 | 192 kbps | 50 GB | 10 GB | 2 |
| Rádio Ultra | 2.000 | 192 kbps | 100 GB | 20 GB | 2 |
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).
Abra os pontos de montagem
No painel:
A lista mostra o
/radio.mp3, marcado como Montagem Padrão (Default Mount). Ele é o que o player público toca.- 1Ponto de Montagem, no menu Transmissão
- 2O /radio.mp3, a Montagem Padrão
- 3Adicionar Ponto de Montagem
Crie o segundo ponto
Clique em Adicionar Ponto de Montagem (Add Mount Point). Na aba Informações básicas (Basic Info):
- 1URL do Ponto de Montagem:
/radio.aacSempre começa com barra e vira o final do endereço de escuta. - 2Exibir Nome: Opcional (ex.:
AAC 64 kbps)Aparece no seletor do player e na Visão Geral. - 3Mostrar em Páginas Públicas: Ligado
- 4Definir como o ponto de montagem padrão: DesligadoO padrão continua sendo o MP3.
- 5URL de retransmissão de stream: Em brancoRetransmitir outra rádio não faz parte do serviço.
- 6Publicar em diretórios "Páginas amarelas": Deixe como está
- 7Duração Máxima do Ouvinte:
0Com 0, o ouvinte fica conectado o tempo que quiser. - 8Ponto de Montagem de Contingência: Deixe como está (
/error.mp3)
- 1URL do Ponto de Montagem:
Escolha o formato
Na aba AutoDJ:
- 1Habilitar AutoDJ: LigadoSem isso, o ponto fica sem a programação do AutoDJ.
- 2Formato do AutoDJ: AAC+ (MPEG4 HE-AAC v2)
- 3Taxa de Bits do AutoDJ (kbps):
64A lista só mostra valores até o máximo do seu plano.
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.
- 1Introdução
- 2Avançado
Salve e peça para aplicar
Clique em Salvar Alterações. 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.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).
Não apague nem renomeie o /radio.mp3
/radio.mp3 é o endereço do player do seu site, dos aplicativos e dos links divulgados: apagar, renomear ou trocar o formato dele derruba tudo isso. O servidor recusa um terceiro ponto (o limite é 2), e qualquer mudança em ponto de montagem só vale depois do reinício feito pela equipe.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.
Ligue a gravação
No painel:
Na aba Streamers/DJs:
- 1Gravar Transmissões Ao Vivo: Ligado
- 2Formato da Gravação de Transmissão Ao Vivo: MP3Também há OGG Vorbis, OGG Opus e AAC+. O MP3 abre em qualquer aparelho.
- 3Taxa de Bits da Gravação de Transmissão Ao Vivo (kbps):
128Quanto maior, maior o arquivo e mais rápido o espaço de gravações enche.
Dica Salve e abra um chamado: a gravação vale depois do reinício feito pela equipe.
Abra as gravações do locutor
No painel:
Depois do programa, o botão Transmissão (Broadcasts) do locutor lista as gravações dele.
Ouça, baixe ou apague
Cada linha é um programa, com a hora de início, a de fim e o tamanho. 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.
- 1Ouvir no navegador
- 2Baixar (Download)
- 3Excluir
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| Campo | O que traz |
|---|---|
now_playing.song.title, .artist e .art | Título, artista e capa da música atual |
now_playing.played_at e .duration | Quando a música começou e quanto dura |
playing_next.song e song_history | A próxima música e as últimas tocadas (quantas, conforme Número de Músicas Recentes) |
listeners.total e listeners.unique | Ouvintes conectados agora e quantos são únicos |
live.is_live e live.streamer_name | Se há locutor ao vivo e o nome dele |
is_online | Se a rádio está transmitindo |
<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.
Locutor ao vivo e o nome da música
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.
O botão Incorporar Widgets, no quadro Páginas Públicas da Visão Geral.
O construtor de widgets, com a visualização e o código.
- 1Visualização Ao Vivo: como o widget vai ficar
- 2Código para Incorporar
- 3Copiar para Área de Transferência
- 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).
Na Visão Geral, os quadros Transmissões e Páginas Públicas.
- 1Endereço de escuta: para players de áudio, aplicativos e o VLC
- 2Baixar PLS e Baixar M3U: listas que abrem a rádio direto em players de computador
- 3Página Pública: o link para divulgar
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.
Prepare as playlists membros
Crie e preencha as playlists que vão formar o relógio (ex.:
Sucessos,NovidadeseVinhetas do relógio).- 1Novidades
- 2Sucessos
- 3Vinhetas do relógio
Crie o grupo
No painel:
Clique em Adicionar Playlist (Add Playlist) e preencha:
- 1Nome da Playlist: Ex.:
Relógio da manhã - 2Fonte: Grupo de Playlist
- 3Ordem de Reprodução da Música: SequencialPara as playlists membros tocarem na ordem que você definir.
- 4Tipo de Playlist e agenda: Como numa playlist comumEx.: Rotação Geral, com horário das 6h às 10h na aba Agendamento.
Dica Clique em Salvar Alterações.
- 1Nome da Playlist: Ex.:
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, clique no botão azul com a seta (Adicionar ao grupo de playlist selecionado). Ajuste a ordem com Mover para Cima e Mover para Baixo.
- 1O grupo, clicado na coluna Playlists
- 2Adicionar ao grupo de playlist selecionado
- 3As playlists do grupo, na ordem em que tocam
- 4Mover para Baixo
Defina quantas músicas de cada uma
Em cada playlist do grupo, no Conteúdo da Playlist:
- 1Reproduções Consecutivas: Quantas músicas seguidas daquela playlist antes de passar para a próxima (ex.:
2em Sucessos)Com 0, toca uma. - 2Reproduzir 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.
Dica Deixe Pedidos Permitidos e Isento de redefinição aninhada como estão.
- 1Reproduções Consecutivas: Quantas músicas seguidas daquela playlist antes de passar para a próxima (ex.:
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.
- 1A aba Associações
- 2Os grupos de que a playlist participa
Uma playlist dentro de um grupo deixa de tocar sozinha
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.
A janela Adicionar Playlist com a fonte URL Remoto.
- 1Fonte: URL Remoto
- 2URL Remoto: o endereço da outra transmissão
- 3Tipo de URL Remota: transmissão Icecast/Shoutcast, playlist M3U/PLS ou outro endereço
- 4Buffer da Reprodução Remota (Segundos): quantos segundos do áudio externo ficam guardados
- 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.
Como saber se deu certo
Depois do reinício, a Visão Geral mostra os dois pontos de montagem em Transmissões, e o endereço /radio.aac toca no celular. Se usou a API, o seu site mostra a música atual e o número de ouvintes.
Problemas comuns
Criei o ponto de montagem AAC, mas o endereço não toca
- Causa provável
- O ponto novo só transmite depois que a transmissão é reiniciada.
- O que fazer
- Abra um chamado pedindo para aplicar. Depois do reinício, teste o endereço completo, com
/listen/, o nome da rádio e/radio.aac.
Não consigo criar outro ponto de montagem
- Causa provável
- O plano permite 2 pontos, e a rádio já tem os dois.
- O que fazer
- Edite o segundo ponto em vez de criar outro (e peça para aplicar).
A API mostra a música antiga por alguns segundos
- Causa provável
- As respostas ficam em cache por 15 segundos.
- O que fazer
- É normal. Consulte a cada 15 ou 30 segundos.
O meu código no site parou de receber dados da API
- Causa provável
- As páginas públicas foram desativadas ou o nome da rádio no endereço (URL Curta) mudou.
- O que fazer
- Confira Ativar Páginas Públicas no perfil e compare o endereço do código com o que aparece na Visão Geral.
Coloquei a Rotação Geral num grupo e a rádio ficou sem música em alguns horários
- Causa provável
- A playlist sem agenda própria passou a tocar só pelo grupo, que tem horário.
- O que fazer
- Tire a playlist do grupo (Remover do grupo, na aba Agrupamento de Playlists) ou crie outra Rotação Geral fora do grupo.
Não resolveu? Veja o diagnóstico por sintoma ou abra um chamado na central do cliente.
Continue aprendendo
- Player e divulgaçãoLeve sua rádio para qualquer lugar: player no site, link e QR CodeOs endereços da rádio, o player oficial do painel, o gerador de código, WordPress, HTTPS, autoplay, celular, QR Code e redes sociais.Iniciante
- AutoDJ e programaçãoAutoDJ: como deixar a web rádio tocando 24 horas com playlistsO que é o AutoDJ, a primeira playlist passo a passo, ordem, peso, tipos de playlist e como o AutoDJ escolhe o que tocar.Iniciante
- EstatísticasEstatísticas da web rádio: ouvintes, horários de pico e relatóriosOuvintes agora, ouvintes únicos, horários de pico, músicas que seguram ou espantam a audiência e o que os números não conseguem medir.Intermediário
Precisa de ajuda com a sua rádio?
Abra um chamado pela central do cliente: a equipe responde em português.