Métadonnées Icecast

Précédent Suivant

Les métadonnées sont livrées au serveur selon une méthode dite « hors bande ». Autrement dit, alors qu'une simple connexion TCP au serveur MR fournit des données audio MP3 ou AAC, les métadonnées (marqueurs de chansons et publicitaires) sont fournies au serveur via une tansaction HTTP, indépendamment des données audio. Les métadonnées sont envoyées au serveur MR en utilisant la méthode HTTP GET.

Les métadonnées peuvent être envoyées au serveur MR à tout moment pendant la diffusion avec une simple requête HTTP.

  • Il peut être utilisé pour envoyer des informations sur l’artiste et le titre aux auditeurs connectés pour la piste en cours de lecture.
  • En théorie, les métadonnées peuvent être utilisées pour insérer des marqueurs publicitaires. Malheureusement, le canal des métadonnées n'est pas synchronisé avec le canal audio, de sorte que le timing peut ne pas être parfait et peut fluctuer dans le temps. Par conséquent, nous ne recommandons pas l'utilisation de marqueurs publicitaires pour les insertions publicitaires dynamiques d'intercalaires, à moins que la qualité et le timing pour cette station ne soient pas importants.
  • Avec le mode personnalisé, vous pouvez les utiliser pour envoyer des notes de pochette ou d'autres messages transmis qui ne concernent pas la piste audio à des auditeurs connectés.

La méthode GET :

GET /admin/metadata?mount=/MOUNTNAME&mode=updinfo&song=Song+-+Title&url=UrlEncodedSubParameters HTTP/1.0\r\n
Authorization: Basic c291cmNlOmhhY2ttZQ==\r\n
\r\n

Response (Réponse)

Code de réponseDescription
200Succès
400Demande invalide ou nom de montage invalide.
401Mot de passe invalide.
404Montage inconnu ou désactivé provisoirement.
500Serveur non disponible.

Le bloc de code GET illustré ci-dessus est un exemple d'URL HTTP que vous devez générer et envoyer au MediaRelay de Triton Digital afin d'insérer des événements de flux (événement de chanson et coupures publicitaires en cours de diffusion).

Les paramètres song et url sont nécessaires pour prendre en charge les mises à jour des métadonnées.

Paramètre de la chanson

Le paramètre song= est un champ textuel libre qui n'est pas officiellement décrit, mais qui, au fil des ans, a pris les formats suivants :

Format
chanson=Titre
chanson=Artiste - Titre
chanson=Artiste - Album - Titre

Triton a ajouté la prise en charge d'un nouveau format song= qui fournit des métadonnées améliorées, dont le remplacement et l'injection d'annonces. Le sujet est abordé plus bas dans ce document sous la section TildeATS.

Paramètre de l'URL

Le paramètre url= peut être utilisé pour fournir des informations supplémentaires sur l’événement en cours, qu’il s’agisse du début d’une chanson/piste ou d’une pause publicitaire en cours de diffusion.

Si le paramètre url=est utilisé, alors le paramètre song= est ignoré.

Le paramètre url= peut contenir une liste de sous-paramètres codés en URL : songtype (type de chanson), style, duration (durée), title (titre), artist (artiste) et album.

  • songtype=S indique le début d'une chanson ou d'un bloc de contenu.
  • songtype=A indique le début d'une coupure publicitaire. Cela déclenchera une pause publicitaire en cours de diffusion.
  • Le style « block » indique le début d'un bloc publicitaire. Cela déclenchera une pause publicitaire en cours de diffusion (mid-roll). Toute autre forme de métadonnées sera ignorée jusqu'à ce qu'un songtype « S » et/ou un style « default » soit transmis.
  • duration indique la durée en secondes de l'événement en cours (facultatif mais recommandé).
  • title indique le titre de l’événement en cours. Il peut être laissé vide (facultatif).
  • artist indique l’artiste de l’événement en cours. Ignoré si la valeur songtype est A (facultatif).
  • album indique l’album de l’événement en cours. Ignoré si la valeur songtype est A (facultatif).

Sous-paramètres

La structure des sous-paramètres est identique à celle des paramètres d'URL standard, mais ils sont codés sous la forme d'une valeur unique pour le paramètre url=.

title=Vogue&artist=Madonna&duration=300&songtype=S

...doit être livrée tel quel :

url=title%3DVogue%26artist%3DMadonna%26duration%3D300%26songtype%3DS

injection publicitaire en cours de diffusion / Remplacement des publicités

Nous ne prenons pas en charge Icecast avec l'injection de publicités intercalaires.

Métadonnées de timing Icecast

Les métadonnées peuvent être envoyées à tout moment à partir de votre outil de diffusion. Il est préférable de faire en sorte que cela soit aussi précis que possible, étant donné la nature « hors bande » en direct de la méthode des métadonnées.

Une fois que le « contenu » et les « métadonnées » arrivent sur le serveur « d'origine » de Triton, cette synchronisation sera reportée dans le système « pas à pas  » et plus aucun écart de temps n'aura lieu.

La lecture instantanée de Shoutcast/Icecast par les auditeurs peut et va réintroduire l’écart de temps. Ce problème peut être facilement résolu en utilisant des lecteurs clients basés sur HLS ou FLV à la place.

Exemples de métadonnées

Type de métadonnées/Métadonnées DurationCommentaireExemple
Début de la chanson
« Madonna - Vogue »
3 min. 20 sec.
http://source:mount_password@server:port/admin/metadata?mount=/MOUNTNAME&mode=updinfo&song=notUsed&url=duration%3D200%26songtype%3DS%26artist%3DMadonna%26title%3Dvogue
url sub parameters sent : duration=200&songtype=S
Pause publicitaire
« Pubs ciblées »
30 secondes
http://source:mount_password@server:port/admin/metadata?mount=/MOUNTNAME&mode=updinfo&song=notUsed&url=title%3DTargeted%20%E2%80%8BAd%20Break%3D%26duration%3D30%26songtype%3DA
url sub parameters sent : title=Targeted Ad Break=&duration=30&songtype=A
Fin de la pause
Pas besoin de titre
Pas nécessaireRequis pour mettre fin à une pause publicitaire si vous utilisez des publicités dans un journal télévisé ou une émission en direct qui ne comporte pas de mise à jour du « titre ».http://source:mount_password@server:port/admin/metadata?mount=/MOUNTNAME&mode=updinfo&song=&url=songtype%3DS
url sub parameters sent : songtype=S

Format de métadonnées TildeATS

Certains outils de diffusion Icecast ne sont pas capables de renseigner le paramètre de l' url . Cela a limité les métadonnées aux chaînes classiques Artiste - Titre, appelées format ATS. Cela exclut le remplacement/injection de publicité, car il n’y a pas d’analyse du paramètre de chanson . Triton a ajouté la prise en charge des métadonnées étendues basées sur les chansons qui activent davantage d’outils de diffusion Icecast, y compris l’option pour les publicités.

Triton a déjà reconnu song=Artist - Title encodé en tant que Artist%20-%20Title  où un espace-hypen-space « » sépare l’artiste et le titre.

Nous reconnaissons maintenant un nouveau séparateur : space-tilde-space où un tilde ( » ~ « ) vous donne plus d’options/contrôle lorsque vos outils ne permettent pas d’utiliser l’url.

  • La chaîne séparée par un tilde doit contenir au moins quatre champs :
    • nom de l'artiste
    • title
    • durée en seconde
    • numéro de catégorie
  • La chaîne séparée par un tilde doit se terminer par le signe circonflexe « ^ ».
  • Les tildes doivent avoir un espace de début et de fin « ~  »

Exemple de métadonnées de morceau :

Billie Eilish ~ Bad Guy ~ 246 ~ 0 ^

URL encodée comme suit :

song=Billie%20Eilish%20~%20Bad%20Guy%20~%20246%20~%200%20%5E

Si la durée n’est pas connue,doivent être fournis.

Exemple pour le remplacement de publicité :

Break ~ Break ~ 60 ~ 4 ^

URL encodée comme suit :

song=Break%20~%20Break%20~%2030%20~%204%20%5E

Exemple pour l'insertion de publicité avec un insert de publicité 1 par défaut :

Break ~ Break ~ 30 ~ 4 ~ I ^

URL encodée comme suit :

song=Break%20~%20Break%20~%2030%20~%204%20~%20I%20%5E

Exemple pour l'insertion de publicité avec un nombre spécifique :

Break ~ Break ~ 30 ~ 4 ~ I ~ 3 ^

URL encodée comme suit :

song=Break%20~%20Break%20~%2030%20~%204%20~%20I%20~%203%20%5E

Categories

À l'heure actuelle, seules deux catégories sont traitées :

  • Musique (0)
  • Commercial (4)

Toutes les autres catégories sont acceptées et traitées comme un événement de Fin de pause.

Les catégories connues à l'heure actuelle sont :

  • Musique : 0
  • Jingle : 1
  • Balayeuse : 2
  • Voix : 3
  • Commercial : 4
  • InternetStream : 5
  • Autres : 6
  • VDF : 7
  • Podcast : 8
  • Demande : 9
  • Nouvelles : 10
  • PlaylistÉvénement : 11
  • FilebyDate : 12
  • NewestfromFolder : 13
  • Teaser : 14
Ignorer la fonctionnalité d'événement de métadonnées (##)

Une fonctionnalité supplémentaire vous permet de faire en sorte que Triton ignore un événement de métadonnées, mais qu’il soit quand même traité comme une Fin de pause. Cela vous permet de mettre fin à un événement de rupture qui ne se retrouvera pas par accident dans un rapport SoundExchange.

Toute chaîne song= commençant par deux hachages « ## » est ignorée de cette manière.

Exemples :

##Ignored - Event

##Ignored ~ Event ~ 300 ~ 0 ^