FR
Français English
Lancer votre station
Centre d'aide Bannière d'état automatique

Bannière d'état automatique

3 min de lecture Dernière mise à jour : 8 octobre 2026

À quoi elle sert

La bannière d'état automatique est un petit widget JavaScript qui surveille l'état de votre flux et affiche une barre de notification rouge dans le haut de votre site Web quand quelque chose ne va pas. Elle vérifie votre flux toutes les 5 secondes et réagit à deux situations :

  • Flux interrompu : votre serveur est inaccessible ou ne répond pas
  • Silence : votre serveur est en ligne, mais il diffuse du silence, ou le signal audio est plat

Quand votre flux va bien, la bannière reste complètement cachée. Vos visiteurs ne la voient jamais, sauf s'il y a un problème.

Comment elle fonctionne

  1. Vous ajoutez une seule balise <script> à votre site Web.
  2. Le script interroge l'API d'état de CloudRadio toutes les 5 secondes.
  3. Si l'état du flux est « down » ou « dead_air », une bannière rouge fixe apparaît dans le haut de la page avec un message d'état.
  4. Quand le flux se rétablit, la bannière disparaît d'elle-même.

La bannière affiche un message par défaut (« Nous examinons des problèmes de connexion à notre flux audio » quand le flux est interrompu, « Investigating audio quality issues » en cas de silence) jusqu'à ce que vous publiiez le vôtre à partir de la page de surveillance.

Installation

Obtenir votre code d'intégration

  1. Allez à Surveillance dans la barre latérale gauche.
  2. Cliquez sur le flux auquel vous voulez ajouter la bannière.
  3. Ouvrez l'onglet Widget. La section Bannière de site Web en montre un aperçu.
  4. Copiez le code affiché sous Code d'installation.

Le code ressemble à ceci :

<script async src="https://public.cloudrad.io/embed/status/YOUR-STREAM-ID/widget.js"></script>

L'ajouter à votre site Web

Collez la balise script juste avant la balise fermante </body> de chaque page où la bannière doit apparaître. La plupart des sites de radio l'ajoutent à la mise en page principale ou au gabarit du thème, pour qu'elle soit présente partout sur le site.

Aucun CSS ni réglage supplémentaire n'est nécessaire. Le widget injecte ses propres styles et place la bannière comme élément fixe dans le haut de la fenêtre d'affichage.

Mettre à jour le message d'état

Tant que votre flux est interrompu, silencieux ou que son signal audio est plat, un champ Message d'état public apparaît dans la carte d'état de cette surveillance.

  1. Allez à Surveillance et cliquez sur le flux touché.
  2. Tapez votre message dans le champ Message d'état public.
  3. Cliquez sur le bouton d'envoi. Le message est mis à jour sur votre site Web en moins de 5 secondes.

Servez-vous-en pour dire aux auditeurs ce qui s'est passé et quand attendre un retour à la normale. Par exemple : « Nous éprouvons des difficultés techniques. De retour sous peu. » ou « Entretien planifié jusqu'à 15 h, heure de l'Est. »

Quand votre flux se rétablit, la bannière disparaît d'elle-même. Le message d'état est réinitialisé quand vous l'effacez dans le tableau de bord.

Tester votre installation

Vous pouvez vérifier que le widget fonctionne sans attendre une vraie panne.

  1. Allez à Surveillance > cliquez sur le flux où le widget est installé.
  2. Ouvrez l'onglet Widget.
  3. Sous Testez votre installation, cliquez sur Envoyer une bannière test. Une bannière de test apparaît sur votre site Web pendant 30 secondes, et le bouton affiche un compte à rebours tant qu'elle est active.

La bannière de test affiche « Test Mode - Widget displayed for 30 seconds to verify installation » : vous (et toute personne qui visite votre site) pouvez ainsi confirmer qu'elle fonctionne.

Détails techniques

DétailValeur
Intervalle d'actualisation5 secondes
Position de la bannièreFixe, dans le haut de la fenêtre d'affichage
Z-index999999
CORSAutorisé depuis n'importe quelle origine
Mise en cacheNo-store (toujours à jour)
En cas d'échecSi l'API est inaccessible, la bannière reste cachée
DépendancesAucune (JavaScript pur, sans cadriciel)

Le widget est servi depuis public.cloudrad.io. Il appelle l'API d'état avec fetch et crée directement les éléments DOM. Aucune bibliothèque externe n'est chargée.

Disponibilité

La bannière d'état automatique est incluse gratuitement avec la surveillance des flux dans tous les forfaits CloudRadio. Vous pouvez ajouter la surveillance de n'importe quel flux Shoutcast, Icecast ou HLS public.

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