Page de référence sur le wiki (EN)
http://wiki.services.openoffice.org/wiki/Java/Java_Media_Framework

Avec Linux et d'autres systèmes de type Unix, OpenOffice.org il faut installer Java Media Framework pour pouvoir intégrer du son et de la vidéo.

Cette page tente d'expliquer comment installer et configurer Java Media Framework pour OpenOffice.org.

Il faut d'abord télécharger le logiciel. Dans les exemples ci-dessous, nous supposerons que vous téléchargez dans le répertoire habituel (sous Linux /home/user/Download ou /home/user/Desktop [remplacez “user” par votre nom d'utilisateur], mais cela peut varier selon votre distribution et votre “locale” - en espagnol, par exemple c'est /home/user/Descargas ou en français /home/user/Bureau → c'est le cas que nous utiliserons ici).

Télécharger le paquet Linux JMF Performance Pack sur le site de Sun:

http://java.sun.com/javase/technologies/desktop/media/jmf/2.1.1/download.html

Ne pas choisir la version *.zip version, mais plutôt le fichier *.bin (la plus récente est nommée jmf-2_1_1e-linux-i586.bin).

Télécharger également le greffon (plugin) JMF MP3 Plugin, si le support mp3 vous intéresse (c'est un format courant aujourd'hui). la dernière version est javamp3-1_0.zip et se trouve aussi sur le site de Sun :

http://java.sun.com/javase/technologies/desktop/media/jmf/mp3/download.html

Dans cette section est expliquée l'installation de JMF. Plutôt que suivre les instructions données sur le site de Sun, une solution beaucoup plus simple à mettre en œuvre est proposée.

D'abord est expliquée l'installation pour le seul utilisateur. Si vous voulez installer JMF sur le système, suivez les mêmes instructions, il faudra simplement ajouter quelques étapes supplémentaires.

Lire d'abord ci-dessous jusqu'à la méthode Multi-utilisateur, la plupart du temps préférable.

Le logiciel a été téléchargé dans /home/user/Bureau. Ouvrir un terminal (dans Gnome c'est gnome-terminal, dans KDE c'est konsole), et aller dans le répertoire en question :

user@pc:~$ cd Bureau
user@pc:~/Bureau$

Créer un nouveau répertoire dans lequel sera décompressé le logiciel, répertoire nommé par exemple JMF :

user@pc:~/Bureau$ mkdir JMF

Copier le fichier binaire JMF Performance Pack dans ce répertoire (il vaut mieux travailler avec une copie du fichier téléchargé, au cas où des problèmes surviendraient durant l'installation, comme l'ont rapporté plusieurs utilisateurs).

user@pc:~/Bureau$ cp jmf-2_1_1e-linux-i586.bin JMF/jmf-2_1_1e-linux-i586.bin

Changer de répertoire pour aller dans celui nommé JMF :

user@pc:~/Bureau$ cd JMF
user@pc:~/Bureau/JMF$

Maintenant modifier les propriétés du fichier pour le rendre exécutable

user@pc:~/Bureau/JMF$ chmod +x jmf-2_1_1e-linux-i586.bin

Exécuter l'installeur (pas besoin des droits du super-utilisateur, ça va seulement décompresser les fichiers, pas les installer):

user@pc:~/Bureau/JMF$ ./jmf-2_1_1e-linux-i586.bin

Le texte de la licence s'affiche. Faites-le défiler en appuyant sur la barre Espace ou Entrée, jusqu'à la demande d'accord :

Do you agree to the above license terms? [yes or no]

Tapez yes pour accepter. Répondez no aux deux questions supplémentaires.

Permit recording from an applet? (see readme.html) [yes or no] 
no

Permit writing local files from an applet? (recommend no, see readme.html) [yes or no]
no

Après avoir répondu à ces questions, la décompression démarre.

À ce moment-là vous pouvez rencontrer une erreur similaire à ceci :

Unpacking... 
tail: cannot open `+309' for reading: No such file or directory 
Extracting...
./install.sfx.25050: line 1: ==: No such file or directory 
./install.sfx.25050: line 3: syntax error near unexpected token `)' 

Si c'est le cas, référez-vous à la section "Problèmes" ci-dessous, puis revenez ici.

Le JMF va essayer de trouver les périphériques de votre système. Ne vous inquiétez pas des messages signalant qu'il ne peut pas ouvrir certains d'entre eux :

java.lang.Error: Can't open video card 1
java.lang.Error: Can't open video card 2
java.lang.Error: Can't open video card 3
java.lang.Error: Can't open video card 4
java.lang.Error: Can't open video card 5
java.lang.Error: Can't open video card 6
...

Ce qui est important, c'est qu'il trouve votre carte son (et la carte vidéo s'il y a lieu). Vous pourrez vérifier ce point ultérieurement depuis le logiciel JMStudio, qui s'installe avec le JMF.

Si tout se passe bien, le JMF sera décompressé dans le répertoire /home/user/Bureau/JMF/JMF-2.1.1e/.

On peut maintenant déplacer le répertoire JMF vers un endroit permanent, dans le système (voir plus bas multi-utilisateurs) ou pour votre seul usage dans votre répertoire personnel :

user@pc:~/Bureau/JMF$ cd .. 
user@pc:~/Bureau$ mv JMF/JMF-2.1.1e ~/

Enfin, on peut effacer le répertoire temporaire :

user@pc:~/Bureau$ rm -rf JMF

L'étape suivante consiste à installer le plugin mp3, s'il vous faut le support des fichiers mp3.

Placez-vous dans le répertoire dans lequel vous avez téléchargé le fichier zip du plugin (la dernière version est javamp3-1_0.zip) :

user@pc:~/$ cd Bureau
user@pc:~/Bureau$ 

Créez un nouveau répertoire pour le décompresser, appelons-le JAVAMP3 :

user@pc:~/Bureau$ mkdir JAVAMP3

Décompressez le fichier zip à l'intérieur de ce nouveau répertoire :

user@pc:~/Bureau$ unzip javamp3-1_0.zip -d JAVAMP3/ 
Archive:  javamp3-1_0.zip 
  inflating: JAVAMP3/copyright.txt 
  inflating: JAVAMP3/license.txt  
   creating: JAVAMP3/lib/ 
   creating: JAVAMP3/lib/ext/
  inflating: JAVAMP3/lib/ext/mp3plugin.jar

Puis copiez l'archive du plugin Java (mp3plugin.jar) dans le répertoire JMF folder, avec les autres fichiers .jar (/home/user/JMF-2.1.1e/lib/):

user@pc:~/Bureau$ cp JAVAMP3/lib/ext/mp3plugin.jar ~/JMF-2.1.1e/lib/

On peut effacer le répertoire temporaire :

user@pc:~/Bureau$ rm -rf JAVAMP3

On revient dans notre répertoire home, prêts à lancer JMStudio, tester la configuration, et ajouter le plugin mp3.

Pour lancer JMStudio, tapez la commande suivante :

user@pc:~/Bureau$ cd ~/JMF-2.1.1e/bin/

user@pc:~$ ./jmstudio

Vous voyez une fenêtre comme celle-ci :

Java Media Studio

Choisissez le menu File - Preferences pour ouvrir le JMF Registry Editor. Dans l'onglet “Capture device”, il devrait y avoir au moins la capture audio JavaSound. Sinon, cliquez sur “Detect Capture Devices”. Des problèmes à ce niveau peuvent être liés à votre matériel et/ou à votre système d'exploitation, cherchez de l'aide à leur sujet en cas de souci.

Dans l'onglet “Plugins”, choisissez l'onglet “Codec”; saisissez com.sun.media.codec.audio.mp3.JavaDecoder puis cliquez sur “Add”, puis sur “Commit”.

JMF Registry Editor

Si rien n'est allé de travers, fermez le JMF Registry Editor, et vous devriez pouvoir jouer un fichier audio mp3. Mais si une fenêtre “JMF Registry Error” apparaît avec un message d'erreur (“Could not add item”), et un message dans le terminal “java.lang.ClassNotFoundException”, fermez alors JMStudio pour régler des variables d'environnement variables, puis relancez JMStudio et ajoutez le codec mp3 comme expliqué ci-dessus :

user@pc:~/JMF-2.1.1e/bin$ ./jmstudio 
java.lang.ClassNotFoundException 
user@localhost:~/JMF-2.1.1e/bin$ export JMFHOME=/home/user/JMF-2.1.1e 
user@localhost:~/JMF-2.1.1e/bin$ export CLASSPATH=$JMFHOME/lib/jmf.jar:$JMFHOME/lib/mp3plugin.jar:$CLASSPATH 
user@localhost:~/JMF-2.1.1e/bin$ export LD_LIBRARY_PATH=$JMFHOME/lib:$LD_LIBRARY_PATH 
user@localhost:~/JMF-2.1.1e/bin$ ./jmstudio

Si vous avez suivi ces étapes, vous devriez maintenant pouvoir configurer OpenOffice.org pour utiliser le JMF. Notez que si vous voulez que le JMF soit accessible à d'autres applications (Java), comme des applets Web, vous devrez régler certaines variables d'environnement. Lisez la section suivante pour les instructions.

Su vous voulez installer le JMF pour tout le système, et qu'il soit disponible pour tous les utilisateurs, suivez les mêmes étapes que ci-dessus, mais déplacez le répertoire ~/JMF-2.1.1e de votre répertoire home vers un emplacement accessible au système. Nous allons choisir /opt. Notez que la configuration du JMF demandera des privilèges root.

user@pc:~/Bureau$ sudo mv JMF/JMF-2.1.1e /opt/

Créez un lien symbolique de référence dans les variables d'environnement (cela facilite les mises à jour) :

user@pc:~/Bureau$ sudo ln -s /opt/JMF-2.1.1e /opt/JMF
[sudo] password for user:

Ensuite il faut régler les variables d'environnement global. On le fait en éditant (ou en créant, s'il n'existe pas encore) un fichier nommé java.sh dans /etc/profile.d/java.sh, avec le contenu suivant :

export JAVA_HOME=/opt/jdk 
export JMFHOME=/opt/JMF 
export CLASSPATH=$JMFHOME/lib/jmf.jar:$JMFHOME/lib/mp3plugin.jar:$JMFHOME/lib/fobs4jmf.jar:$CLASSPATH 
export LD_LIBRARY_PATH=$JMFHOME/lib:$LD_LIBRARY_PATH 
export PATH=$JAVA_HOME/bin:$JMFHOME/bin:$PATH 

Modifiez JAVA_HOME avec l'emplacement du JRE (ou JDK).

Pour le trouver :

user@pc:~/Bureau$ sudo find / -name jre
[sudo] password for user: 
/usr/lib/jvm/java-6-sun-1.6.0.10/jre

Nous parlerons plus tard de fobs4jmf.jar. Notez que toutes les commandes d'export doivent se trouver sur une seule ligne ; si le moteur Wiki modifie cela à l'affichage de la page, éditez votre fichier /etc/profile.d/java.sh en supprimant les sauts de ligne éventuels.

Voilà ce que donne sur ma machine le fichier /etc/profile.d/java.sh :

export JAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.10/jre
export JMFHOME=/opt/JMF 
export CLASSPATH=$JMFHOME/lib/jmf.jar:$JMFHOME/lib/mp3plugin.jar:$JMFHOME/lib/fobs4jmf.jar:$CLASSPATH 
export LD_LIBRARY_PATH=$JMFHOME/lib:$LD_LIBRARY_PATH 
export PATH=$JAVA_HOME/bin:$JMFHOME/bin:$PATH 

Après avoir redémarré votre système, chaque utilisateur devrait pouvoir taper jmstudio en ligne de commande pour lancer JMStudio, sans devoir le faire depuis le répertoire d'installation (/opt/JMF-2.1.1e/bin/).

Avant de pouvoir utiliser le Java Media Framework pour reproduire de l'audio et de la vidéo dans OpenOffice.org, vous devez ajouter le répertoire de la bibliothèque JMF au chemin de classe de la machine virtuelle Java lancée par OpenOffice.org. On fait ça depuis la boîte de dialogue Java sous Outils - Options :

Outils - Options, réglages Java

Cliquez sur le bouton “Chemin de la classe”, et ajoutez le répertoire de la bibliothèque JMF (si vous avez choisi l'installation sur le système, c'est /opt/JMF/lib ; si vous n'avez fait l'installation du JMF que dans votre répertoire personnel, c'est alors /home/user/JMF-2.1.1e/lib).

Réglages du chemin de classe Java

Il faut redémarrer OpenOffice.org pour que les changements prennent effet.

image5

Après le redémarrage, vous devriez pouvoir jouer de l'audio et du son supporté par JMF. Vous pouvez essayer de jouer un ds sons de la Gallery :

image6

revenir à l'installation de JMF

Si vous avez une erreur comme celle-ci :

Unpacking... 
tail: cannot open `+309' for reading: No such file or directory 
Extracting...
./install.sfx.25050: line 1: ==: No such file or directory 
./install.sfx.25050: line 3: syntax error near unexpected token `)' 

vous devrez éditer l'installeur et corriger une ligne.

Il y a plusieurs façons de faire, on va utiliser l'éditeur vim.

On remet d'abord tout à zéro, car cette erreur corrompt le fichier installeur. Vous pouvez tester cela en vérifiant sa taille :

user@pc:~$ cd Bureau/JMF/
user@pc:~/JMF$ ls -l .  
total 8 \\ 
-rwxrw-r-- 1 user user 4022 ene 21 09:44 install.sfx.25050 
-rwxr-xr-x 1 user user    0 ene 21 09:44 jmf-2_1_1e-linux-i586.bin

Effacez tout et recopiez le fichier initialement téléchargé :

user@pc:~/JMF$ rm -f * 
user@pc:~/JMF$ cp ../jmf-2_1_1e-linux-i586.bin . 
user@pc:~/JMF$ chmod +x jmf-2_1_1e-linux-i586.bin 

Ouvez le fichier avec vim en mode binaire (option -b) :

user@pc:~/JMF$ vim -b jmf-2_1_1e-linux-i586.bin

image7

Dans l'éditeur, tapez /tail et appuyez sur Entrée pour chercher la ligne à corriger :

image8

Cela va trouver la ligne qui pose problème.

image9

Appuyez alors sur la touche l (left, gauche) pour vous déplacer à gauche de cette ligne jusqu'au signe +.

Apuuyer sur la touche i (insertion) pour insérer du texte, et insérez -n , avec une espace

image10

Appuyez sur Échap pour sortir du mode insertion, puis tapez :wq pour écrire (:w , write) et quitter (:q).

Le Java Media Framework de Sun ne supporte que peu de formats. Vous pouvez l'étendre en installant Fobs4JMF, qui est un wrapper JMF pour ffmpeg, il peut lire les plus courants des formats et codecs (ogg, mp3, m4a, divx, xvid, h264, mov, avi, etc.) :

image11

Voyez http://fobs.sourceforge.net pour plus de détails.

Il n'y a malheureusement pas de binaires récents pour Linux (voir http://sourceforge.net/project/showfiles.php?group_id=105646&package_id=117443), aussi vous faudra-t-il le compiler depuis les sources.

Une fois compilé, il n'y a rien à installer, il suffit de copier fobs4jmf.jar et libfobs4jmf.so dans /opt/JMF/lib/.

À FAIRE : l'explication (complexe) sur comment le compiler (au moins avec Ubuntu) sur demande… Voir l'onglet Discussion, où cela a été demandé, ou ceux capables de le faire, et merci !