Accueil du site > Lecteurs audio > FreeRadio > Le plugin SPIP FreeRadio 1.0

Le plugin SPIP FreeRadio 1.0

vendredi 8 juin 2012, par Franck Ruzzin

FreeRadio est un lecteur de flux audio gratuit écrit en actionscript.
Facile à intégrer, il est possible de l’implanter en pleine page ou dans une nouvelle fenêtre, pour ne pas perdre le signal tout en surfant, comme illustré ci-dessous.
Dans la section Liens sont indiqué des annuaires de WebRadios.

Instance freeRadio1

freeradio1

Alternative content

Get Adobe Flash player

play
stop
isPlaying ?
getVolume
setVolume (0 à 1)
getPan
setPan (-1 à 1)
volume :  ? getRadioUrl
pan :  ? setRadioUrl
Etat :  ?

 

Instance freeradio2

freeradio2

Alternative content

Get Adobe Flash player

play
stop
isPlaying ?
getVolume
setVolume (0 à 1)
getPan
setPan (-1 à 1)
volume :  ? getRadioUrl
pan :  ? setRadioUrl
Etat :  ?

 

 

Ouvrir FreeRadio dans une fenêtre

 


 

I) Implantation du plugin

1) 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.)

2) 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..., 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 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 compris entre -1 et 1

- freeRadio.getRadioUrl(idRadio:String):String

Retourne l’URL du flux audio en cours de lecture

- freeRadio.setRadioUrl(idRadio:String,url:String)

Fixe l’URL du flux audio à lire

 

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)

 

Formats

FreeRadio lit les flux radio de divers formats, cependant certains protocoles ne sont pas supportés :
  • mms
  • rtmp
  • wma
  • aac
Du moins, pour le moment.....

 

 

Creative Commons License Le plugin FreeRadio est mis à disposition selon les termes de la licence Creative Commons Paternité-Partage des Conditions Initiales à l’Identique 2.0 France.

Documents joints

Répondre à cet article