Le plugin FreeRadio 1.0

I Implantation du plugin

1) Voir un exemple d’utilisation
Sur le site lededansdubocal.net

2) Installation classique :
Extraire le contenu de l’archive freeradio-spip-1-0.zip, dans le dossier plugins de votre installation SPIP.
L’activer via l’administration des plugins. (Consulter la documentation officielle pour plus de détails.)

3) Installation automatique :
Créer un sous-dossier /plugins/auto pour permettre l’installation automatique de plugins. Il suffit ensuite d’indiquer l’URL du fichier zip du plugin et de suivre les indications du système (l’installation automatique est disponible à partir de SPIP 2.0).
Pour le plugin freeradio-spip-1-0, l’URL à indiquer est :
http://lededansdubocal.net/IMG/zip/freeradio-spip-1-0.zip

Dans ce plugin, on utilise l’utilitaire javascript d’installation d’objet Flash swfobject 2.2. S’il n’est pas installé, le plus simple est d’installer Le plugin SPIP SWFObject 2.2 disponible à l’adresse http://lededansdubocal.net/Le-plugin-SPIP-SWFObject-2-2.html

II - Le modèle mod_freeradio

Lorsque le plugin est activé, il permet l’utilisation du modèle mod_freeradio, qui implante un lecteur FreeRadio dans la page.

La syntaxe complète est :

<mod_freeradioxxx -> ou xxx est l'id que l'on souhaite donner au lecteur
|radioURL=URL à ouvrir (radio, son) -> par défaut http://tai-02.egihosting.com/bombayb-256k-mp3.pls
|autoStart=Démarrage automatique au chargement de l'URL radio. true ou false -> par défaut true
|volume=Décimal de 0 à 1 -> par défaut 0.7
|pan=Décimal de -1 (gauche) à 1 (droite) -> par défaut 0
|onVolumeChange=Méthode à exécuter lorsque le volume change. par défaut : exécute la méthode "onVolumeChange"
|onPanChange=Méthode à exécuter lorsque la balance change. par défaut : exécute la méthode "onPanChange"
|onStop=Méthode à exécuter lorsque la lecture s'arrête. par défaut : exécute la méthode "onStop"
|onPlay=Méthode à exécuter lorsque la lecture démarre. par défaut : exécute la méthode "onPlay"
|right ou left ou center>

Par exemple :

<mod_freeradio10
|radioURL=http://www.afrikmedia.com/afrikmedia.ram
|autoStart=false
|volume=0.6
|pan=0.5
|onVolumeChange=whenVolumeChange
|onPanChange=whenPanChange
|onStop=whenStop
|onPlay=whenPlay
|right>

Insère un lecteur FreeRadio : id=10, url de radio=http://www.afrikmedia.com/afrikmedia.ram, démarrage manuel, volume=0.6, balance=0.5 (moitié droite), flottant à droite et qui exécute les méthodes javascript :
-  whenVolumeChange lorsque le volume change
-  whenPanChange lorsque la balance change
-  whenStop lorsque la lecture s’arrête
-  whenPlay lorsque la lecture débute

III - Le modèle mod_freeradiopopup

Lorsque le plugin est activé, il permet l’utilisation du modèle mod_freeradiopopup, qui implante un lecteur FreeRadio dans une nouvelle fenêtre après un clic du visiteur.

La syntaxe complète est :

<mod_freeradiopopupxxx -> ou xxx est l'id que l'on souhaite donner au lecteur
|radioURL=URL à ouvrir (radio, son) -> par défaut http://tai-02.egihosting.com/bombayb-256k-mp3.pls
|autoStart=Démarrage automatique au chargement de l'URL radio. true ou false -> par défaut true
|volume=Décimal de 0 à 1 -> par défaut 0.7
|pan=Décimal de -1 (gauche) à 1 (droite) -> par défaut 0
>

Par exemple :

<mod_freeradiopopup2
|radioURL=http://live.campusgrenoble.org:9000/rcg112.m3u
|autoStart=false
|volume=0.3
|pan=0.5>

Insère un lecteur FreeRadio : id=2, url de radio=http://live.campusgrenoble.org:9000/rcg112.m3u, démarrage manuel, volume=0.3, balance=0.5 (moitié droite) qui tente d’exécuter les méthodes javascript :
-  onVolumeChange lorsque le volume change
-  onPanChange lorsque la balance change
-  onStop lorsque la lecture s’arrête
-  onPlay lorsque la lecture débute

Remarque : Dans l’espace d’administration, les lecteurs FreeRadio sont représentés par l’image « Get FLASH PLAYER ». Cela est normal. On visualise ainsi qu’il y a à cet endroit de l’article un objet implanté, mais le voir (ou plutôt l’entendre) n’a pas d’intérêt ici.

IV) Pilotage javascript d’un lecteur FreeRadio

freeRadio.play(idRadio:String)
Lance la lecture du lecteur d’identifiant idRadio

freeRadio.stop(idRadio:String)
Stoppe la lecture du lecteur d’identifiant idRadio

freeRadio.isPlaying(idRadio:String):Boolean
Retourne un booléen indiquant si le lecteur d’identifiant idRadio est en mode lecture (true) ou en mode arrêt (false)

freeRadio.getVolume(idRadio:String):Number
Retourne le volume actuel du lecteur d’identifiant idRadio, compris entre 0 et 1

freeRadio.setVolume(idRadio:String,vol:Number)
Fixe le volume du lecteur d’identifiant idRadio, vol est compris entre 0 et 1

freeRadio.getPan(idRadio):Number
Retourne la balance actuelle du lecteur d’identifiant idRadio, compris entre -1 et 1

freeRadio.setPan(idRadio:String,pan:Number)
Fixe la balance du lecteur d’identifiant idRadio, pan est compris entre -1 et 1

freeRadio.getRadioUrl(idRadio:String):String
Retourne l’URL du flux audio en cours de lecture par le lecteur idRadio

freeRadio.setRadioUrl(idRadio:String,url:String)
Fixe l’URL du flux audio à lire pour le lecteuyr idRadio

V) Evènements javascript lancés par un lecteur FreeRadio

onVolumeChange(idRadio:String,newVol:Number)
Lorsque le volume du lecteur d’identifiant idRadio change, la méthode définie par flashvars.onVolumeChange est exécutée (si flashvars.onVolumeChange n’est pas défini, c’est la méthode onVolumeChange qui est exécutée)

onPanChange(idRadio:String,newPan:Number)
Lorsque la balance du lecteur d’identifiant idRadio change, la méthode définie par flashvars.onPanChange est exécutée (si flashvars.onPanChange n’est pas défini, c’est la méthode onPanChange qui est exécutée)

onStop(idRadio:String)
Lorsque le lecteur d’identifiant idRadio s’arrête, la méthode définie par flashvars.onStop est exécutée (si flashvars.onStop n’est pas défini, c’est la méthode onStop qui est exécutée)

onPlay(idRadio:String)
Lorsque le lecteur d’identifiant idRadio commence la lecture, la méthode définie par flashvars.onPlay est exécutée (si flashvars.onPlay n’est pas défini, c’est la méthode onPlay qui est exécutée)

VI) Liens

• listenlive.eu : European radio stations streaming live on the internet
• Canadian Web Radio : Canada’s Guide to Internet Radio
• US Live Radio : United States radio stations streaming live on the internet
• Australian Live Radio : Australian Radio Stations Streaming Live on the Internet
• NZ Radio Guide : New Zealand Radio Stations Streaming Live on the Internet
• Screamer Radio : Free Internet Radio

VII) Formats

FreeRadio lit les flux radios de divers formats, cependant certains protocoles ne sont pas supportés :

• mms
• rtmp
• wma
• aac

Du moins, pour le moment.....