Esta guía detalla la gestión y visualización de las metadatos (títulos, artistas) y las portadas de álbumes para una transmisión de Radio en streaming / DJ automático al utilizar un reproductor de audio personalizado.

Requisitos previos

• Obtenga el identificador de su emisora: el valor station_id es imprescindible para consultar las API de metadatos y portadas; se trata del ID de la emisora y no del paquete de emisoras, que puede encontrar:
  • mediante una llamada a la API,
  • o directamente desde la URL de su panel de control en el Manager de Infomaniak: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard

Consultar los metadatos de las canciones que se están reproduciendo

La visualización dinámica de los títulos y las portadas en un reproductor personalizado se basa en solicitudes a una API pública (sin necesidad de autenticación); puede obtener la lista de metadatos (❓: ayuda) de las 100 últimas canciones reproducidas en su emisora a través de un navegador o mediante una solicitud GET:

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

Formato de los datos devueltos

El último título transmitido se encuentra siempre al final de la lista. Cada título se describe en el siguiente formato:

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

Detalles:

• title: metadato formateado como ARTISTA - TÍTULO
• date: marca de tiempo de inicio del título, expresada en tiempo Unix
• microtime: marca de tiempo precisa hasta el microsegundo, expresada en tiempo Unix
• duración: duración del título en segundos (solo se muestra si el título no se está reproduciendo, y corresponde a la diferencia en segundos entre la recepción de los metadatos de este título y del siguiente).
• portada: este campo no se utiliza en esta ruta y devuelve el valor null; para obtener las portadas, consulte la sección que se muestra a continuación.

Nota: la marca de tiempo se expresa en tiempo Unix; se puede convertir automáticamente o mediante herramientas en línea como UnixTimestamp o EpochConverter…

Recuperar las portadas de los álbumes

Tiene a su disposición dos rutas de API para recuperar la portada de una canción en su radio:

1. Portada del título que se está reproduciendo (recomendado):
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Indique la hora UTC actual en formato Unix en el parámetro currentTimeOfPlayer. Se recomienda este método por su rapidez de ejecución.
2. Lista de las últimas portadas:
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   Este método devuelve todas las portadas más recientes que se están transmitiendo en la radio.