Questa guida illustra come gestire e visualizzare i metadati (titoli, artisti) e le copertine degli album per uno streaming di Radio in streaming / Auto DJ quando si utilizza un lettore audio personalizzato.

Prerequisiti

• Ottenere l'ID della tua emittente radio: il valore station_id è indispensabile per interrogare le API dei metadati e delle copertine; si tratta dell'ID dell'emittente e non del pacchetto radio, che puoi trovare:
  • tramite una chiamata API,
  • o direttamente dall'URL del tuo pannello di controllo su Infomaniak Manager: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard

Consultare i metadati dei brani in onda

La visualizzazione dinamica dei titoli e delle copertine su un lettore personalizzato si basa su richieste API pubbliche (senza necessità di autenticazione); è possibile ottenere l'elenco dei metadati (❓: guida) degli ultimi 100 titoli trasmessi sulla propria radio tramite un browser o tramite una richiesta GET:

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

Formato dei dati restituiti

L'ultimo titolo trasmesso si trova sempre alla fine della lista. Ogni titolo è descritto nel seguente formato:

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

Dettagli:

• title: metadato formattato nel formato ARTISTA - TITOLO
• date: timestamp di inizio del titolo espresso in tempo Unix
• microtime: timestamp preciso al microsecondo espresso in tempo Unix
• duration: durata del brano in secondi (presente solo se il brano non è in riproduzione, corrispondente alla differenza in secondi tra la ricezione dei metadati di questo brano e del brano successivo).
• cover: questo campo non viene utilizzato in questa route e restituisce il valore null; per ottenere le copertine, consultare la sezione riportata di seguito.

Nota: l'indicazione temporale è espressa in tempo Unix; può essere convertita automaticamente o tramite strumenti online come UnixTimestamp o EpochConverter…

Recuperare le copertine degli album

Sono disponibili due endpoint API per recuperare la copertina di un brano nella tua radio:

1. Richiesta della copertina del titolo in riproduzione (consigliato):
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Inserire l'ora UTC corrente in formato Unix nel parametro currentTimeOfPlayer. Questo metodo è consigliato per la sua velocità di esecuzione.
2. Elenco delle copertine recenti:
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   Questo metodo restituisce l'elenco completo delle copertine più recenti trasmesse dalla radio.