FR
Français English
Lancer votre station
Centre d'aide Indicateur de source en direct

Indicateur de source en direct

3 min de lecture Dernière mise à jour : 14 novembre 2026

Les stations CloudRadio One signalent quelle entrée est réellement en ondes. Votre site Web peut donc afficher un indicateur de direct pendant qu'un DJ diffuse, et le masquer quand AutoDJ joue. Le widget JavaScript et l'API d'état donnent tous deux cette information, et tous deux distinguent l'Entrée Studio, l'Entrée DJ invité et l'entrée DJ qui sert aux émissions de DJ programmées.

L'indicateur reflète ce que les auditeurs entendent, pas qui est connecté. Si l'encodeur d'un DJ est connecté mais que le flux est déjà retombé sur un relais ou sur AutoDJ, l'indicateur signale la source que les auditeurs entendent vraiment. Il change à l'instant où la station change de source; en HLS, les auditeurs entendent le changement environ 10 secondes plus tard, soit la portion du délai du direct qui s'ajoute après la station.

Cet article concerne les stations CloudRadio One, qui font tourner notre AutoDJ et nos entrées en direct. Les flux hébergés sur votre propre serveur Shoutcast ou Icecast ne font pas la distinction entre direct et automatisé : les champs décrits ici en sont donc absents.

Attributs du widget

Si vous utilisez déjà le widget JavaScript, aucun script supplémentaire n'est nécessaire. Le widget définit deux attributs sur #stream_info_status :

AttributValeurs
data-sourcelive, relay ou automated
data-source-namestudio, guest ou dj, seulement quand data-source vaut live

data-source-name est retiré quand aucune entrée en direct n'est en ondes : une règle CSS qui s'appuie sur cet attribut ne se déclenche donc jamais par accident.

Ajouter un élément de source en direct

Pour afficher le nom de l'entrée en direct sous forme de texte, ajoutez cet élément n'importe où dans votre page :

<span id="stream_info_live_source"></span>

Le widget y écrit Studio, Guest DJ ou DJ tant que cette entrée est en ondes, et le vide (chaîne vide) le reste du temps. L'élément porte les mêmes attributs data-source et data-source-name que l'élément d'état : vous pouvez donc lui donner son propre style.

Vous trouverez cet extrait, avec un bouton pour le copier et un aperçu en direct, sous Widgets texte, dans la page Widgets et liens de votre station dans Studio.

Styler l'indicateur

Les attributs servent de point d'ancrage pour le style. Comme le widget écrit du texte brut et n'impose jamais son propre style, c'est votre feuille de style qui décide de toute l'apparence :

/* an on air light only while a real person is on the mic */
#stream_info_status[data-source="live"] {
  color: #dc2626;
  font-weight: 600;
}

#stream_info_status[data-source="live"]::before {
  content: "";
  display: inline-block;
  width: .5em;
  height: .5em;
  margin-right: .45em;
  border-radius: 50%;
  background: currentColor;
}

/* tell the live inputs apart */
#stream_info_status[data-source-name="guest"] { color: #7c3aed; }

/* hide the live source label whenever nothing live is airing */
#stream_info_live_source:not([data-source="live"]) { display: none; }

Le widget interroge la station toutes les 10 secondes : l'indicateur peut donc accuser jusqu'à environ 15 secondes de retard quand un DJ passe en ondes.

Lire l'information dans l'API d'état

Si vous écrivez votre propre JavaScript au lieu d'utiliser le widget, la même information se trouve dans l'objet source de l'API d'état de la station :

"source": {
  "type": "live",
  "collaborator": "studio",
  "relay": null
}
ChampSignification
source.typelive quand l'une des entrées en direct est en ondes, relay quand un relais est en ondes, automated quand AutoDJ joue
source.collaboratorstudio, guest ou dj quand type vaut live, sinon null

Toutes les entrées en direct renvoient type: "live". L'entrée précise se trouve toujours dans collaborator : une page qui veut seulement savoir si quelqu'un est en ondes peut donc se contenter de lire type. Une station hors ligne renvoie automated.

L'adresse du point d'accès, le reste des données renvoyées, le CORS et la mise en cache sont décrits dans la référence de l'API d'état de la station.

Le même état se trouve aussi sur le point d'accès de données du widget, https://embed.clrd.net/api/your-subdomain/info.json, sous la forme d'un objet source_state avec les clés type et name.

Cela vous a-t-il aidé?

Encore besoin d'aide?

Si vous n'avez pas trouvé la réponse, notre équipe est là pour vous aider.

Ouvrir un billet d'assistance