Base de conhecimento

Este guia aborda as informações de escuta do Rádio Streaming Infomaniak, que podem ser exportadas através do protocolo FTP. Esses registros (dos quais também são obtidas as estatísticas de escuta (❓: ajuda) após a “limpeza” ou “tratamento”) são então transferidos automaticamente por FTP para serem processados posteriormente.

Introdução

• Os registos da sua rádio serão fornecidos sob a forma de um ficheiro comprimido xyz.mp3-20140805.log.gz (a data do registo está no formato YYYYMMDD).
• Cada registo começa às 04:00, hora da Suíça, e termina às 03:59:59 do dia seguinte.
• O registro tem o seguinte formato: ip user-identifier authuser [data-hora] "requisição" status bytes "referer" "useragent" listening-time:

  • 81.56.215.98 - - [09/Apr/2019:08:23:18 +0200] "GET /toto.mp3 HTTP/1.1" 200 1211297 "-" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) Gecko/2019032711 Ubuntu/8.10 (intrepid) Firefox/3.0.8" 69

  • Pode acontecer que a linha do registro esteja mal formatada, devido a um referer muito longo, por exemplo; esse comportamento do Icecast não pode ser alterado.
• Os endereços da faixa IP 84.16.67.128/25 devem ser ignorados, pois são os servidores de streaming.
• Na página de configurações do painel de controle, você pode solicitar novamente os logs dos dias anteriores.
• Você também pode exportá-los diretamente para o ACPM (❓: ajuda) ou para o Mediapulse (❓: ajuda).

Ativar o envio de logs por FTP

Para isso:

1. Clique aqui para acessar o gerenciamento do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique no nome do fluxo de áudio em questão.
4. Clique em Configurações no menu lateral esquerdo.
5. Ative a exportação de logs por FTP com o botão de alternância.
6. Insira um nome de host: endereço do servidor FTP.
7. Insira um nome de usuário: o nome da conta FTP.
8. Insira uma senha: a senha da conta FTP.
9. Insira o diretório no servidor onde os logs serão armazenados.
10. Clique no botão Salvar na parte inferior da página:
    

Processar os logs

O ideal é usar uma expressão regular como a que se segue:

"/^(\S+)\s(.+)\s(\S+)?\s\[((\d\d)\/([a-zA-Z]{3,3})\/(\d\d\d\d)\:(\d\d)\:(\d\d)\:(\d\d)\s\+\d\d\d\d)\]\s"GET\s\/([\-a-z0-9]{1,40}(\.)?(mp3|aac|ogg){0,1})(.*)?"\s(\d{3,3})\s(\d+)\s"(.+)"\s"(.+)"\s(\d+)$/i";

Esta sintaxe é a da função PHP preg_match e deverá ser adaptada caso sejam utilizadas outras funções/linguagens.

A função preg_match retorna um array cujas posições significativas são as seguintes:

Este guia detalha a funcionalidade Auto DJ do serviço de Streaming de Rádio Infomaniak, que permite gerar uma rádio ao vivo 24 horas por dia a partir do seu próprio conteúdo de áudio (músicas, programas, podcasts, vinhetas, etc.) previamente carregado no seu espaço de armazenamento.

Organizar e importar os seus ficheiros de áudio

Pré-requisitos

• Ativar o Auto DJ na sua Rádio Online (❓: ajuda).

O primeiro passo é preparar seus conteúdos. A ferramenta aceita atualmente arquivos nos formatos .mp3 e .aac. Você pode importar uma pasta inteira contendo seus arquivos de áudio:

A pasta padrão tem o nome Music. Você pode criar novas pastas nela para importar os arquivos do seu dispositivo.

O gerenciamento da sua biblioteca também pode ser feito diretamente no seu espaço VOD/AOD:

Gerenciamento de metadados

É possível modificar diretamente as tags ID3 (título, artista, álbum, capa) de um arquivo de áudio a partir da interface, para que essas informações sejam exibidas corretamente em seus reprodutores de áudio:

Criar listas de reprodução

Depois de importar os seus ficheiros, pode agrupá-los em listas de reprodução:

Lista de reprodução manual

1. Crie uma lista de reprodução manual:
   
2. Selecione as músicas e a ordem em que serão reproduzidas:
   

Lista de reprodução automática

1. Selecione uma lista de reprodução automática:
   
2. Abaixo, defina critérios inteligentes (por etiquetas, estilos ou artistas) para que o sistema gere dinamicamente a lista de reprodução:
   

Lista de reprodução avançada

Ao contrário das listas de reprodução mencionadas acima, a lista de reprodução avançada permite programar uma sequência precisa de conteúdos que será reproduzida em loop durante o período de tempo selecionado. Esta funcionalidade é ideal para inserir automaticamente vinhetas ou intervalos em intervalos regulares e para agrupar faixas de várias fontes em um único período de tempo:

1. Selecione uma lista de reprodução avançada:
   
2. Abaixo, defina a estrutura dos seus ciclos de reprodução, combinando diferentes fontes da sua biblioteca (pastas, listas de reprodução ou etiquetas) e indicando o número de faixas a serem reproduzidas para cada elemento:
   
   Exemplo de programação:
   • Reproduzir 3 faixas da lista de reprodução Músicas de filmes
   • Reproduzir 1 faixa da pasta Night
   • Reproduzir 1 som com a etiqueta Jingle
3. O Auto DJ reproduzirá então a sequência em loop (1 → 2 → 3 → 1 → 2 → 3, etc.).
   • Um mecanismo de ponderação garante uma rotação justa dos conteúdos: o sistema não reproduzirá as mesmas faixas ao mesmo tempo, garantindo assim uma renovação real do seu conteúdo a cada ciclo.

Agendar a transmissão (Planeamento)

A ferramenta de planeamento permite gerir a sua grelha de programas de forma muito detalhada:

• Programação por períodos: organize suas transmissões por playlist ou por pasta em um calendário semanal:
  
• Playlist de preenchimento (existente por padrão): configure uma playlist de reserva que será transmitida automaticamente quando nenhum programa específico estiver programado, garantindo assim um fluxo ininterrupto.
• Transição ao vivo / AutoDJ: você pode programar horários ou automatizar a retomada do fluxo AutoDJ assim que um codificador (fonte externa) parar de transmitir seu fluxo.

Parâmetros de áudio avançados

Para garantir uma qualidade de áudio profissional, várias opções de processamento estão disponíveis:

• Normalização do áudio: uniformiza o nível sonoro de todos os seus arquivos para evitar diferenças de volume entre as músicas.
• Transições: configure os efeitos de sobreposição (crossfade) e as sobreposições entre as faixas:
  

Integração e estatísticas

O fluxo gerado pelo Auto DJ é um fluxo de streaming padrão que se beneficia de todas as ferramentas do ecossistema Infomaniak:

• Player Infomaniak: exibição automática dos títulos em reprodução e do histórico de transmissão.
• Distribuição em múltiplos formatos: suporte ao HLS e transcodificação dos fluxos.
• Estatísticas avançadas: acompanhamento preciso do seu público em tempo real e relatórios detalhados.

Este guia explica como configurar corretamente um fluxo no Streaming de rádio Infomaniak.

Configurar a transmissão de um fluxo de rádio

Para acessar o serviço de streaming de rádio:

1. Clique aqui para acessar o gerenciamento do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique no nome da rádio.
4. Clique no botão Configurar fluxos:
   
5. Clique no botão Adicionar um fluxo:
   
6. Adicionar um feed padrão (consulte este outro guia sobre os servidores de feed).
7. Clique no botão para Continuar:
   
8. Escolha as opções desejadas, incluindo a possibilidade de ativar o HLS, que não será contabilizado no número total de fluxos.
9. Configure a qualidade desejada e consulte este outro guia se precisar de informações sobre o tipo de fluxo.
10. Ajuste o tamanho do buffer, se necessário (e não se esqueça de guardar as alterações, se for o caso).
11. Clique no botão para Guardar e sair:
    

Agora pode configurar uma aplicação com as definições obtidas no final deste processo.

Este guia trata das informações de audiência do Rádio Online que podem ser exportadas para o Mediapulse.

Introdução

• Mediapulse, uma organização independente na Suíça, mede a audiência de rádio, televisão e plataformas online.
• Esses dados, reconhecidos como referência oficial, ajudam o mercado de mídia e publicidade a analisar, comparar e estruturar suas atividades.
• Sob a supervisão do DETEC, através da OFCOM, a Mediapulse garante transparência, independência e rigor científico; assegura medições fiáveis e adaptadas à evolução dos meios de comunicação.
• É possível exportar os seus registos de rádio para este serviço.
• Consulte também este outro guia sobre um serviço semelhante, mas destinado à França.

Gerenciar a certificação Mediapulse

Pré-requisitos

• A organização na qual o serviço de streaming está inserido deve estar estabelecida com um endereço na Suíça.
• Para ativar a certificação Mediapulse, entre em contato com este serviço por e-mail:info@mediapulse.ch.
• Após estabelecer o contrato com eles,entre em contato com o suporte da Infomaniakindicando as informações relativas ao seu contrato Mediapulse e Infomaniak.

Para gerenciar a ativação ou desativação do serviço:

1. Clique aqui para acessar o gerenciamento do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique no nome do fluxo de áudio em questão.
4. Clique em Configurações no menu lateral esquerdo.
5. Ative ou desative a exportação dos logs para o Mediapulse com o botão de alternância:
   ‍

Este guia explica como transferir os fluxos de áudio presentes em uma de suas Rádios Online Infomaniak para uma de suas outras rádios, que estejam na mesma Organização.

Transferir os fluxos de áudio

Para isso:

1. Clique aqui para acessar o gerenciamento do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique em o menu de ações ⋮ localizado à direita do elemento em questão.
4. Escolha Transferir:
   
5. Procure e valide o nome da outra estação de rádio que você possui na mesma Organização.
6. Valide a transferência:
   

Atualize as páginas do painel de controle, se necessário, para atualizar as informações exibidas.

Este guia aborda o controle ao vivo (timeshift), que permite aos seus ouvintes pausar, retroceder e, em seguida, retornar à transmissão ao vivo dos seus fluxos HLS, com uma profundidade de retrocesso de até 2 horas.

Introdução

• Ao contrário do Timeshift Streaming de Vídeo, não existe uma ferramenta de agendamento relacionada ao lado do Rádio.
• A reprodução/retrocesso está desativada por padrão no Player para que você tenha controle sobre a exposição ao público.

Oferecer o controle ao vivo aos ouvintes

Pré-requisitos

• Criar ou editar um fluxo HLS no seu produto Streaming de Rádio.

Em seguida:

1. Ao criar (ou modificar) um fluxo HLS, defina o Buffer entre 00:00:25 e 02:00:00. Este valor, entre 25 segundos e 2 horas, corresponde à duração máxima durante a qual os ouvintes podem retroceder e pausar a transmissão ao vivo, antes de retornar à transmissão ao vivo. Ele determina a profundidade do controle ao vivo. Exemplos:
   
   • 00:00:25 → 05:00: tolerância mínima para pausas curtas.
   • 10:00 → 30:00: ideal para formatos de notícias/talk.
   • 30:00 → 02:00:00: conforto máximo para programas de música e eventos.
2. Ativar a função de retomar a reprodução no seu reprodutor (consulte este outro guia) se desejar disponibilizá-la aos ouvintes (desativada por padrão):
   

Este guia apresenta o HLS, que segmenta o seu áudio para uma transmissão HTTP confiável, compatível e altamente distribuível, ideal para públicos móveis e grandes audiências.

O que é HLS?

HLS (HTTP Live Streaming) é um protocolo de transmissão em fluxo que divide o áudio em pequenos segmentos de alguns segundos e publica um manifesto .m3u8 listando esses segmentos. O reprodutor baixa esses segmentos via HTTP/HTTPS (portas 80/443), o que facilita o armazenamento em cache, a retomada após interrupção e a distribuição em larga escala.

No seu serviço de Streaming de Rádio, a ativação do HLS adiciona um fluxo adicional dedicado. Ele possui sua própria URL de reprodução (manifesto HLS) e pode ser selecionado e priorizado no reprodutor Infomaniak. O fluxo HLS coexiste com seus fluxos existentes (por exemplo, MP3/AAC), sem interrupção do serviço.

Vantagens para um fluxo de rádio

• Compatibilidade alargada: suporte nativo em iOS/iPadOS (Safari) e amplo suporte através de leitores HTML5 modernos e aplicações de terceiros.
• Escalabilidade e desempenho: distribuição via HTTP(S), facilmente distribuível por CDN e caches; melhor escalabilidade do que um fluxo contínuo único.
• Robustez: em caso de pequenas interrupções, o leitor pode recuperar os segmentos seguintes e retomar rapidamente; menos suscetível a perdas momentâneas.
• Atravessa firewalls: funciona nas portas 80/443, sendo geralmente mais bem aceito por firewalls e proxies corporativos do que alguns fluxos “ICY”.
• HTTPS simplificado: entrega segura sem plugins ou protocolos exóticos.
• Adaptação de taxa de bits (ABR): quando várias variantes são oferecidas, o reprodutor pode alternar automaticamente de acordo com a qualidade da rede, a fim de limitar interrupções em dispositivos móveis.
• Flexibilidade de integração: uma porta de escuta distinta permite expor o HLS como fluxo principal, secundário ou de backup no seu reprodutor.

Particularidades e pontos de atenção

• Latência: o HLS adiciona uma latência geralmente da ordem de algumas dezenas de segundos (relacionada com o tamanho dos segmentos e o buffering). Isso é normal para este protocolo.
• Leitor compatível necessário: utilize o player Infomaniak ou um leitor/SDK web que suporte os manifestos .m3u8.
• Ambiente heterogêneo: alguns receptores de hardware mais antigos (rádios web, rádios de carro IP) aceitam apenas fluxos MP3/Icecast; mantenha as URLs históricas em paralelo.
• ABR condicional: a adaptação da taxa de bits só é eficaz se vários perfis forem publicados; caso contrário, o fluxo HLS continua a funcionar com uma única qualidade.

Este guia explica como manter o controle sobre seus fluxos de rádio online MP3/AAC ou HLS, ativando a proteção por chave única (token), para decidir, por exemplo, se um ouvinte pode ou não ouvir sua rádio.

Introdução

• A cada conexão, você fará uma solicitação à API Infomaniak, que retornará um token exclusivo com uma duração de vida limitada e configurável.
• Este token autorizará qualquer pessoa que o possua a acessar o fluxo durante esse período.
• Você pode proteger um fluxo MP3/AAC ou HLS independentemente um do outro (o mesmo vale para a geolocalização).
• A ativação da restrição implica uma alteração na configuração do fluxo, o que pode levar alguns minutos para ser replicado nos servidores.

Proteger um fluxo de áudio com uma chave única

Para isso, basta acessar as configurações de restrições e ativar a proteção por token no fluxo que você deseja proteger:

1. Clique aqui para acessar o gerenciamento do seu produto no painel de controle Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão:
   
3. Clique em:
   1. no nome da rádio:
      
   2. ou em Restrições no menu lateral esquerdo para aplicar restrições a todo o produto:
      
4. Ao selecionar a acima, clique em Restrições no menu lateral esquerdo.
5. Se necessário, escolha HLS.
6. Clique no menu de ação ⋮, localizado à direita do item em questão.
7. Clique em Restrição por token:
   
   

Em seguida, ative a proteção.

Atenção: ao ativar esta opção, o acesso ao fluxo será bloqueado instantaneamente para novas conexões.Adapte os seus Players para que considerem a restrição, conforme ilustrado no exemplo abaixo:

Criar um token de API Radio

Para ter acesso à API Radio, você deve primeiro autenticar-se usando um token de aplicação. Esta etapa só precisa ser realizada uma vez. Para criar este token de aplicação, consulte este outro guia.

O escopo é radio e a duração é ilimitada para evitar a necessidade de regenerar um código regularmente. Após gerar o token, copie-o para colá-lo no exemplo abaixo.

Exemplo de utilização em linguagem PHP

Para MP3/AAC ou HLS, o código pode ser praticamente o mesmo, sendo apenas a URL chamada no POST que muda na sua forma.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

Vamos criar o token. A URL para criar o token é estruturada da seguinte forma:

• Para um fluxo MP3 / AAC

POST {{URL_11}}

Exemplo para proteger https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac: a rota será: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Para um fluxo HLS

POST {{URL_14}}

Exemplo para proteger https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8, o endereço será: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Exemplo no caso de MP3/AAC, lembre-se de ajustar:

$token = request(
    'POST',
   '{{URL_17}}',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

É importante notar que, se este código for gerado no momento do carregamento da página, o utilizador terá “window” segundos para iniciar a reprodução do fluxo. Após esse período, o token expirará e o fluxo não poderá ser iniciado, a menos que a página seja recarregada. Dependendo das suas necessidades e do seu caso de uso, será necessário ajustar este período da melhor forma possível.

Também será necessário substituir abaixo a URL de reprodução do seu fluxo, no lugar daquela indicada, mantendo o parâmetro $token no final. Por fim, exibimos o reprodutor (aqui, uma simples tag html5, mas podemos adicionar qualquer camada adicional, passando o token nos parâmetros $_GET da URL).

$streamUrl = "{{URL_18}}";
echo "<audio controls=""><source src="$streamUrl"></audio>";

Este guia aborda as estatísticas do Rádio Online, que permitem, entre outras coisas, verificar possíveis interrupções no fluxo.

Analisar as estatísticas recentes

Para aceder a esta informação:

1. Clique aqui para aceder à gestão do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão:
   
3. Clique em Estatísticas no menu lateral esquerdo:
   
4. Clique em Público em tempo real no menu lateral esquerdo.
5. Escolha uma data para carregar o gráfico correspondente.
6. Passe o cursor sobre as interrupções indicadas por cores para obter mais informações:
   
7. Aproxime o gráfico com a roda do mouse ou selecionando o período.
8. Você pode retornar à visualização inicial clicando no canto inferior direito:
   

Este guia detalha a configuração de um reprodutor para o seu Streaming de Rádio Infomaniak.

Pré-requisitos

• Adicionar 1 reprodutor usando o modelo Infomaniak.

Configurar as opções do reprodutor Infomaniak

Depois de vincular o seu fluxo ao seu reprodutor e de o seu reprodutor ser criado:

1. Clique aqui para acessar o gerenciamento do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique em Meus reprodutores no menu lateral esquerdo.
4. Clique no nome do reprodutor a ser configurado (ou adicione um novo reprodutor clicando no botão acima):
   

1. Guia Aparência

É aqui que pode escolher o tamanho do reprodutor (grande, médio, mini ou reprodutor de várias rádios) e a sua percentagem de exibição.

Pode personalizar as cores do fundo, dos botões e do texto:

Um botão de alternância permite ativar ou desativar a exibição das faixas reproduzidas, com ou sem os seus horários de reprodução:

• Consulte os detalhes sobre este assunto no final deste guia.

O reprodutor pode exibir:

• uma ilustração que representa a capa do álbum ou uma imagem de substituição, caso não esteja disponível,
• uma imagem estática (3 MB máx.),
• o logotipo da sua rádio, que pode personalizar aqui:
  
• uma visualização do espectro de áudio (Espectrograma/Espectro).

2. Separador Transmissão

É aqui que pode associar os seus fluxos de rádio (HLS ou não) ao seu reprodutor que está a configurar.

Consulte este outro guia sobre as opções disponíveis para a gestão da transmissão em direto:

3. Separador Miniaturas (pré-visualização da mídia)

É aqui que pode alterar a imagem de pré-visualização (miniatura) visível no reprodutor do ouvinte quando a mídia está a carregar ou indisponível/restrita:

4. Separador Informações do reprodutor

É aqui que pode dar um nome ao seu reprodutor e decidir se quer mostrar ou ocultar:

• o título e o artista em vez do nome da rádio,
• o número de ouvintes,
• o logótipo da Infomaniak.

5. Separador Opções de partilha

Um botão de alternância (toggle switch) permite ativar ou desativar certos serviços, como o Facebook:

Uma vez ativado, um botão de compartilhamento para esses serviços será visível no seu Player:

Detalhes do histórico de transmissão (guia #1)

O histórico de transmissão permite ouvir novamente as músicas transmitidas (entre 1 e 40), caso o seu fluxo seja do tipo HLS (você poderá então definir um buffer que varia de 25 segundos a 2 horas):

A funcionalidade de retroceder e ouvir novamente não está ativada por padrão: ela permanece opcional, a fim de respeitar as restrições de alguns países ou rádios. Uma vez ativada, o administrador da rádio pode escolher quais fluxos estarão disponíveis para transmissão (consulte a guia #2 acima), enquanto o ouvinte pode selecionar a qualidade do áudio no Player:

Position & intégration de l'historique de diffusion

A lista pode ser consultada das seguintes formas:

• diretamente abaixo do Player,
• no Player,
• ou em uma janela separada na integração do seu site…

De fato, é possível exibir o histórico em uma segunda iframe, distinta da do Player principal. Exemplo de URL para o Player:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

E para o histórico arquivado:

https://player-radio.infomaniak.com/2/prod/history

As duas iframes devem ser integradas na mesma página e comunicam entre si para atualizar o histórico ou iniciar uma faixa que já foi transmitida.

Um segundo modo de integração permite exibir um histórico autônomo, sem a iframe principal. Basta adicionar o ID do Player à URL:

Este guia detalha a gestão e a exibição das metadados (títulos, artistas) e das capas de álbuns para um fluxo de Rádio Online / DJ automático ao utilizar um leitor de áudio personalizado.

Pré-requisitos

• Obtenha o identificador da sua rádio: o valor station_id é indispensável para consultar as APIs de metadados e capas; trata-se do ID da estação e não do pacote de rádio, que pode encontrar:
  • através de uma chamada API,
  • ou diretamente a partir da URL do seu painel de controlo no Manager Infomaniak: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard

Consultar os metadados das músicas transmitidas

A exibição dinâmica de títulos e capas em um reprodutor personalizado é baseada em solicitações de API públicas (sem necessidade de autenticação); você pode obter a lista de metadados (❓: ajuda) dos 100 títulos mais recentes transmitidos em sua rádio por meio de um navegador ou por meio de uma solicitação GET:

https://metadata.infomaniak.com/api/radio/{station_id}/metadata

Formato dos dados retornados

O último título transmitido está sempre no final da lista. Cada título é descrito no seguinte formato:

{
  "duration": 565,
  "date": 1791303566,
  "microtime": 1791303566.10439,
  "title": "ARTIST - SONG TITLE",
  "cover": null
}

Detalhes:

• title: metadado formatado como ARTISTA - TÍTULO
• data: carimbo de data e hora de início do título, expresso em tempo Unix
• microtime: carimbo de data e hora preciso, com resolução em microssegundos, expresso em tempo Unix
• duração: duração do título em segundos (presente apenas se o título não estiver em reprodução, correspondendo à diferença em segundos entre o recebimento dos metadados deste título e do seguinte).
• capa: este campo não é utilizado nesta rota e retorna o valor null; para obter as capas, consulte a seção abaixo.

Observação: o carimbo de data/hora é expresso em tempo Unix; pode ser convertido automaticamente ou por meio de ferramentas online, como UnixTimestamp ou EpochConverter…

Recuperar as capas dos álbuns

Duas rotas de API estão disponíveis para recuperar a capa de uma música na sua rádio:

1. Capa do título que está sendo reproduzido (recomendado):
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Informe a hora UTC atual em formato Unix no parâmetro currentTimeOfPlayer. Este método é recomendado pela sua rapidez de execução.
2. Lista das capas mais recentes:
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   Este método retorna todas as capas mais recentes transmitidas na rádio.