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.