Si vous créez le lecteur de votre site web vous-même au lieu d'utiliser le lecteur intégrable de CloudRadio, le module CloudRadio HLS vous permet de lire votre flux HLS avec des réglages optimisés pour l'audio en direct.
L'URL de votre liste de lecture HLS principale figure sur la page Widgets et liens de Studio. Elle ressemble à ceci :
https://hls.cloudrad.io/your-slug/stream.m3u8
Le module CloudRadio HLS
CloudRadio publie un petit module JavaScript qui enveloppe hls.js et y ajoute des réglages de débit adaptatif (ABR) pensés pour la radio en direct. Avec lui, votre lecteur se comporte comme le lecteur officiel de CloudRadio : choix stable de la variante et solution de repli pour Safari compris.
<audio id="player" controls></audio>
<script src="https://assets.clrd.net/assets/js/cloudradio-hls.js"></script>
<script>
CloudRadio.play(
document.getElementById("player"),
"https://hls.cloudrad.io/your-slug/stream.m3u8"
)
</script>
La fonction play renvoie une promesse qui est résolue dès que le flux est prêt et rejetée en cas d'erreur de lecture fatale. La valeur résolue expose une méthode destroy(), qui libère proprement les ressources quand vous changez de flux.
La fonction de rappel onError est aussi appelée lorsqu'une erreur fatale survient après le début de la lecture. Dans ce cas, la session n'est pas détruite pour vous : appelez sa méthode destroy() avant de relancer la lecture.
<script>
let session = null
async function start(url) {
if (session) session.destroy()
session = await CloudRadio.play(document.getElementById("player"), url, {
onError: (data) => console.warn("HLS error", data),
})
}
</script>
Le module est servi par le CDN de CloudRadio (assets.clrd.net), avec une politique CORS permissive et une mise en cache de longue durée. Il fonctionne dans tous les navigateurs modernes et se rabat sur la lecture HLS native dans Safari et dans les anciennes versions d'iOS, où les Media Source Extensions ne sont pas offertes.
Ajouter les métadonnées en direct
Pour afficher le titre de la chanson en cours, le nombre d'auditeurs et d'autres données en direct à côté de votre lecteur personnalisé, ajoutez le script d'information de CloudRadio, très léger :
<script src="https://public.cloudrad.io/your-slug/streaminfo.js"></script>
<p>Now playing: <span id="stream_info_song">...</span></p>
<p>Listeners: <span id="stream_info_listeners">...</span></p>
Le script interroge le serveur toutes les 10 secondes et met à jour chaque élément dont l'identifiant correspond. Consultez Widgets et liens pour la liste complète des éléments pris en charge et l'API JSON.
Dépannage
La lecture ne démarre pas sur iOS. Safari mobile exige un geste de l'utilisateur (un toucher ou un clic) avant de pouvoir lire du son. Déclenchez audio.play() dans un gestionnaire click, et non au chargement de la page.
Erreurs CORS au chargement du module. Le module CloudRadio HLS est servi depuis assets.clrd.net avec l'en-tête Access-Control-Allow-Origin: *. Si vous voyez des erreurs CORS, vérifiez bien que vous le chargez depuis https://assets.clrd.net/assets/js/cloudradio-hls.js et non depuis une vieille copie locale.