Dieser Leitfaden beschreibt die Verwaltung und Anzeige von Metadaten (Titel, Interpreten) und Albumcovern für einen Streaming-Radiosender / Auto-DJ, wenn ein benutzerdefinierter Audioplayer verwendet wird.

Voraussetzungen

• Ermitteln Sie die ID Ihres Radiosenders: Der Wert station_id ist unerlässlich, um die Metadaten- und Cover-APIs abzufragen. Es handelt sich um die ID des Senders und nicht um das Radiopaket. Sie finden diese:
  • über einen API-Aufruf,
  • oder direkt in der URL Ihres Dashboards im Infomaniak Manager: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard

Metadaten der aktuell gespielten Titel abrufen

Die dynamische Anzeige von Titeln und Covern auf einem benutzerdefinierten Player basiert auf öffentlichen API-Abfragen (ohne Authentifizierung); Sie können die Liste der Metadaten (❓: Hilfe) der letzten 100 auf Ihrem Radiosender gespielten Titel über einen Browser oder durch eine GET-Anfrage abrufen:

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

Format der zurückgegebenen Daten

Der zuletzt wiedergegebene Titel befindet sich immer am Ende der Liste. Jeder Titel wird im folgenden Format beschrieben:

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

Details:

• title: Metadatum, formatiert als KÜNSTLER - TITEL
• date: Startzeitstempel des Titels, ausgedrückt in Unix-Zeit
• microtime: Präziser Zeitstempel auf Mikrosekundenebene, ausgedrückt in Unix-Zeit
• duration: Dauer des Titels in Sekunden (wird nur angezeigt, wenn der Titel nicht gerade abgespielt wird; entspricht der Zeitdifferenz in Sekunden zwischen dem Empfang der Metadaten dieses Titels und des nächsten Titels).
• cover: Dieses Feld wird in dieser Schnittstelle nicht verwendet und gibt den Wert null zurück; Informationen zum Abrufen von Covern finden Sie im Abschnitt unten.

Sprache: Deutsch Inhalt: Hinweis: Die Zeitangabe erfolgt im Unix-Format; sie kann automatisch oder mithilfe von Online-Tools wie UnixTimestamp oder EpochConverter konvertiert werden … UnixTimestamp ou EpochConverter…

Albumcover abrufen

Es stehen zwei API-Routen zur Verfügung, um das Albumcover eines Titels in Ihrem Radio abzurufen:

1. Abrufen des Titels des aktuell wiedergegebenen Tracks (empfohlen):
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Geben Sie die aktuelle UTC-Zeit im Unix-Zeitformat als Parameter currentTimeOfPlayer an. Diese Methode wird aufgrund ihrer schnellen Ausführungszeit empfohlen.
2. Liste der kürzlich gespielten Titel:
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   Mit dieser Methode werden alle kürzlich im Radio gespielten Titel abgerufen.