Mediaplayer (HomePlayer 1.5 et +) : Raccourcis claviers et

Mediaplayer (HomePlayer 1.5 et +) :
Raccourcis claviers et pilotage du
Mediaplayer à l'aide d'une télécommande
HomePlayer : raccourcis claviers et contrôle via une
télécommande
1) Actions disponibles dans le mediaplayer...........................................................2
A) Actions relatives aux comportements de la fenêtre.......................................2
B) Actions relatives aux menus et au fonctions supplémentaires du ................2
mediaplayer......................................................................................
..................2
C) Actions relatives aux commandes du player .................................................4
D) Actions relatives au player en mode DVD......................................................6
E) Actions relatives au player en mode Photos...................................................7
2) Pilotage du mediaplayer à l'aide de raccourcis clavier......................................8
3) Pilotage du mediaplayer à l'aide d'une télécommande.....................................9
A) Prérequis...................................................................................................
......9
B) Télécommande de référence........................................................................10
C) Fichiers de configurations........................................................................
.....11
ANNEXE A : fichier de référence hp.lirc pour la télécommande Freebox v4.........12
ANNEXE B : exemple de fichier lircd.conf pour la télécommande freebox v4......17
ANNEXE C : exemple de fichier de configuration hardware.conf..........................18
ANNEXE D : Messages d'erreurs...........................................................................19
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
1) Actions disponibles dans le mediaplayer
HomePlayer possède un ensemble d'actions prédéfinies permettant d'étendre les
commandes de la fenêtre du mediaplayer à d'autres types d'interfaces : contrôle
du mediaplayer via des raccourcis clavier ou via une télécommande.
A) Actions relatives aux comportements de la fenêtre
•
•
•
•
•
•
•
ACTION_WINICONIFIED : elle permet d'icônifier la fenêtre du mediaplayer
ACTION_WINMAXIMIZE : elle permet de maximiser la fenêtre du
mediaplayer
ACTION_WINOPENCLOSE : elle permet d'activer ou fermer la fenêtre du
mediaplayer
ACTION_WINDECORED : elle permet d'activer ou de désactiver les
décorations de la fenêtre
ACTION_WINALWAYSONTOP : elle permet de mettre la fenêtre au premier
plan
ACTION_ZOOMMINUS : elle permet de réduire la taille de la fenêtre du
player
ACTION_ZOOMPLUS : elle permet d'augmenter la taille de la fenêtre du
player
B) Actions relatives aux menus et au fonctions supplémentaires du
mediaplayer
•
ACTION_HPUNIVERS : elle permet d'afficher les univers disponibles dans le
mediaplayer (menu de gauche)
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
•
ACTION_PLAYLIST : elle permet d'afficher la playlist relative à un univers
sélectionné (menu de droite)
•
ACTION_PIP : elle permet d'activer ou de désactiver la fonction PIP (Picture
in Picture)
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
•
ACTION_PROGTV : elle permet d'afficher/cacher la fenêtre du guide TV
C) Actions relatives aux commandes du player
•
ACTION_INFO : elle permet d'afficher les infos relatives au media en cours
de lecture
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
•
•
•
ACTION_PLAYPAUSE : elle permet de mettre en route ou de mettre en
pause un media sélectionné dans la playlist
ACTION_STOP : elle permet de stopper la lecture d'un media sélectionné
ACTION_RECORD : elle permet de lancer un enregistrement d'un media
sélectionné
Les contrôles du volume :
•
•
•
ACTION_VOLUMEDOWN : elle permet de baisser le volume du media en
cours de lecture
ACTION_VOLUMEUP : elle permet d'augmenter le volume du media en
cours de lecture
ACTION_VOLUMEMUTE : elle permet de rendre muet le media en cours de
lecture
Les commandes de navigation dans les playlists :
•
•
ACTION_NEXT : elle permet d'aller au media suivant sélectionné dans la
playlist
ACTION_PREV : elle permet d'aller au media précédent sélectionné dans la
playlist
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
•
•
ACTION_ADDFAVORITE : elle permet d'ajouter le media en cous de lecture
dans ses favoris
Les fonctions suivantes correspondent aux numéros 0 à 9 :
•
ACTION_KEY1 : numéro 1
•
ACTION_KEY2 : numéro 2
•
ACTION_KEY3 : numéro 3
•
ACTION_KEY4 : numéro 4
•
ACTION_KEY5 : numéro 5
•
ACTION_KEY6 : numéro 6
•
ACTION_KEY7 : numéro 7
•
ACTION_KEY8 : numéro 8
•
ACTION_KEY9 : numéro 9
•
ACTION_KEY0 : numéro 0
La gestion des numéros à deux ou trois chiffres est aussi prise en charge, un
appui long sur un numéro permet d'obtenir les dizaines, un appui long sur le
deuxième numéro sélectionné permet d'obtenir les centaines :
D) Actions relatives au player en mode DVD
•
•
•
ACTION_TITLENEXT : elle permet d'aller au titre suivant
ACTION_TITLEPREV : elle permet d'aller au titre précédent
ACTION_CHAPITERNEXT : elle permet d'aller au chapitre
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
•
•
•
ACTION_CHAPTERPREV : elle permet d'aller au chapitre précédent
ACTION_CHGLANG : elle permet de changer de langue
ACTION_CHGSUBTITLE : elle permet de changer les sous-titres
E) Actions relatives au player en mode Photos
•
ACTION_TURNRIGHT : elle permet de faire une rotation de 90° vers la
droite de la photo
•
ACTION_TURNLEFT : elle permet de faire une rotation de 90° vers la
gauche de la photo
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
2) Pilotage du mediaplayer à l'aide de raccourcis clavier
Il est possible de contrôler le mediaplayer de HomePlayer à l'aide de raccourcis
clavier. Chaque action disponible dans le mediaplayer (cf 1 Actions disponibles)
peut être mapper par un raccourci clavier.
Les raccourcis clavier de référence se trouvent dans le fichier
répertoire_installation_HomePlayer/webapps/ROOT/bases/keys.ini
Le fichier keys.ini se présente comme suit :
[ACCELERATOR]
ACTION_PREDEFINIE_DU_MEDIAPLAYER = TOUCHE_CLAVIER_CORRESPONDANTE
ou
ACTION_PREDEFINIE_DU_MEDIAPLAYER = ctrl TOUCHE_CLAVIER_CORRESPONDANTE
Les touches spécifiques <alt>, <shift>, <ctrl> au format texte dans le fichier de
configuration seront associées automatiquement aux touches spéciales du
clavier.
Ci-dessous l'ensemble des raccourcis de bases fournis avec HomePlayer qui
constituera le modèle de référence :
[ACCELERATOR]
ACTION_PLAYPAUSE = SPACE
ACTION_STOP
=S
ACTION_NEXT
= UP
ACTION_PREV
= DOWN
ACTION_INFO
=I
ACTION_PLAYLIST
= F2
ACTION_TITLENEXT = ctrl T
ACTION_TITLEPREV = ctrl shift T
ACTION_CHAPITERNEXT = ctrl Y
ACTION_CHAPTERPREV = ctrl shift Y
ACTION_CHGLANG
= ctrl L
ACTION_CHGSUBTITLE = ctrl S
ACTION_ADDFAVORITE = F4
ACTION_PROGTV
=T
ACTION_RECORD
=R
ACTION_PIP
=P
ACTION_TURNRIGHT = <
ACTION_TURNLEFT
=>
ACTION_VOLUMEDOWN = SUBTRACT
ACTION_VOLUMEUP
= ADD
ACTION_VOLUMEMUTE = M
ACTION_ZOOMMINUS = ctrl SUBTRACT
ACTION_ZOOMPLUS
= ctrl ADD
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
ACTION_HPUNIVERS = F5
ACTION_WINDECORED = D
ACTION_WINCLOSE
= alt F4
ACTION_WINALWAYSONTOP = F3
ACTION_KEY1 = NUMPAD1
ACTION_KEY2 = NUMPAD2
ACTION_KEY3 = NUMPAD3
ACTION_KEY4 = NUMPAD4
ACTION_KEY5 = NUMPAD5
ACTION_KEY6 = NUMPAD6
ACTION_KEY7 = NUMPAD7
ACTION_KEY8 = NUMPAD8
ACTION_KEY9 = NUMPAD9
ACTION_KEY0 = NUMPAD0
NOTE : Il est possible d'utiliser ces raccourcis claviers pour associer les contrôles
du mediaplayer à une télécommande.
3) Pilotage du mediaplayer à l'aide d'une télécommande
A) Prérequis
Le pilotage du mediaplayer à l'aide de la télécommande repose sur les projets
LIRC1 pour les systèmes *nix : GNU/LInux et Mac OS X, et WinLIRC pour les
systèmes Windows.
Le projet WinLIRC ne marche qu'avec des périphériques sur le port série,
contrairement à LIRC pour systèmes *nix qui peut prendre en charge tout type
de périphériques infrarouge (du port série aux adaptateurs infrarouge sur port
USB en passant par les adaptateurs inclus avec certaines cartes TV ou DVB-S/T.
Il existe cependant pour le projet WinLirc des plugins pour différents types de
télécommande et différents types de logiciel :
•
Plugin WinLirc pour les télécommandes de type Ati Remote Wonder :
http://remotew.free.fr/plugins.htm#winlirc
•
Un Pont (bridge) pour les télécommandes Hauppauge :
http://www.oliver-frietsch.de/wtvirbridge/index.php?lng=en
•
Un plugin pour le logiciel Girder :
http://www.promixis.com/download.php?ID=219
•
Un client WinLIRC pour le logiciel Autohotkey :
http://www.autohotkey.com/docs/scripts/WinLIRC.htm
1 http://www.lirc.org et http://winlirc.sourceforge.net/
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
B) Télécommande de référence
La télécommande de référence ainsi que les actions associées à chaque bouton
correspondent à ceux de la télécommande de la Freebox V4 (cf figure a cidessous).
Figure a : « Mapping » de référence des actions
pour le contrôle du mediaplayer à
l'aide d'une télécommande
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
C) Fichiers de configurations
Les commandes à affecter à la télécommande se trouvent dans le fichier hp.lirc,
il doit être impérativement placer dans le répertoire $HOME/.homeplayer pour
les systèmes *nix et C:\Documents and Settings\nom_utilisateur\.homeplayer
pour les systèmes Windows., Un exemple de référence sera placé dans le
répertoire répertoire_installation_HomePlayer/webapps/ROOT/bases/
La configuration d'une action pour le mediaplayer se présente comme suit :
begin
remote = NOM_DE_LA_TELECOMMANDE
prog = HomePlayer
button = NOM_DU_BOUTON
config = ACTION_PREDEFINIS_DU_MEDIAPLAYER
repeat= TAUX_DE_REPETITION_DU_SIGNAL_INFRAROUGE
end





remote : correspond au nom de la télécommande défini dans le fichier de
configuration lircd.conf pour les systèmes *nix et mon_fichier.cfg pour les
systèmes Windows.
prog : correspond au nom du programme à utiliser, ici HomePlayer ;-)
button : le bouton associé à l'action prédéfinie (bouton spécifié dans les
fichiers de configurations de sa télécommande lircd.conf pour les systèmes
*nix ou mon_fichier.cfg pour les systèmes Windows).
config : correspond au type d'action prédéfinie du mediaplayer
repeat : correspond au taux de répétition du signal infrarouge :
•
0 : pas de répétition du signal
•
1 : répétition rapide (en rafale)
•
2 : répétition tous les deux signaux
•
n : répétition tous les n signaux
Ci-dessous un exemple de commande avec la touche ? de la télécommande de
référence (affichage des univers disponibles sur la partie droite du mediaplayer)
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = ?
config = ACTION_HPUNIVERS
repeat= 0
end
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
ANNEXE A : fichier de référence hp.lirc pour la télécommande Freebox v4
## HomePlayer FREEBOX_V4 remote reference##
## boutons ?, OPTIONS, TV/AV, ON/OFF ##
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = ?
config = ACTION_HPUNIVERS
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = OPTIONS
config = ACTION_PIP
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = TV/AV
config = ACTION_WINDECORED
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = ON/OFF
config = ACTION_WINOPENCLOSE
repeat=0
end
## boutons couleurs RED(rouge), GREEN (vert), YELLOW(jaune),BLUE(bleu) ##
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = RED
config = ACTION_TURNLEFT
repeat=32
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = GREEN
config = ACTION_TURNRIGHT
repeat=32
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = YELLOW
config = ACTION_ZOOMMINUS
repeat=32
end
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = BLUE
config = ACTION_ZOOMPLUS
repeat=32
end
## boutons VOL-, VOL+, P+, P-, OK(fullscreen) ##
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = VOLconfig = ACTION_VOLUMEDOWN
repeat=32
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = VOL+
config = ACTION_VOLUMEUP
repeat=32
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = Pconfig = ACTION_PREV
repeat=32
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = P+
config = ACTION_NEXT
repeat=32
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = OK
config = ACTION_WINMAXIMIZE
repeat=0
end
## boutons MUTE, INFO, GUIDE, STOP, PLAY/PAUSE, REC ##
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = MUTE
config = ACTION_VOLUMEMUTE
repeat=0
end
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = INFO
config = ACTION_INFO
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = GUIDE
config = ACTION_PROGTV
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = PLAY/PAUSE
config = ACTION_PLAYPAUSE
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = STOP
config = ACTION_STOP
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = REC
config = ACTION_RECORD
repeat=0
end
## boutons 0...9 ##
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 0
config = ACTION_KEY0
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 1
config = ACTION_KEY1
repeat=1
end
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 2
config = ACTION_KEY2
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 3
config = ACTION_KEY3
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 4
config = ACTION_KEY4
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 5
config = ACTION_KEY5
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 6
config = ACTION_KEY6
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 7
config = ACTION_KEY7
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 8
config = ACTION_KEY8
repeat=1
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = 9
config = ACTION_KEY9
repeat=1
end
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
## boutons X, MAIL, HEART, HOME ##
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = X
config = ACTION_WINCLOSE
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = MAIL
config = ACTION_CHGLANG
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = HEART
config = ACTION_ADDFAVORITE
repeat=0
end
begin
remote = FREEBOX_REMOTE
prog = HomePlayer
button = HOME
config = ACTION_PLAYLIST
repeat=0
end
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
ANNEXE B : exemple de fichier lircd.conf pour la télécommande freebox v4
begin remote
name
FREEBOX_REMOTE
bits
12
flags SPACE_ENC|CONST_LENGTH
eps
30
aeps
100
one
550 4505
zero
550 1976
ptrail
551
gap
79667
min_repeat
1
toggle_bit
5
begin codes
ON/OFF
TV/AV
OPTIONS
?
RED
GREEN
YELLOW
BLUE
MUTE
INFO
GUIDE
STOP
PLAY/PAUSE
REC
OK
P+
PVOLVOL+
X
MAIL
HEART
HOME
1
2
3
4
5
6
7
8
9
0
*
#
end codes
end remote
0x0000000000000D1D
0x0000000000000D15
0x0000000000000D38
0x0000000000000D3B
0x0000000000000D39
0x0000000000000D1E
0x0000000000000D3E
0x0000000000000D31
0x0000000000000D1F
0x0000000000000D20
0x0000000000000D21
0x0000000000000D23
0x0000000000000D24
0x0000000000000D22
0x0000000000000D33
0x0000000000000D34
0x0000000000000D35
0x0000000000000D36
0x0000000000000D37
0x0000000000000D29
0x0000000000000D2A
0x0000000000000D3C
0x0000000000000D3D
0x0000000000000D00
0x0000000000000D08
0x0000000000000D10
0x0000000000000D01
0x0000000000000D09
0x0000000000000D11
0x0000000000000D02
0x0000000000000D0A
0x0000000000000D12
0x0000000000000D0E
0x0000000000000D18
0x0000000000000D05
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
ANNEXE C : exemple de fichier de configuration hardware.conf (version Linux
avec module lirc_sir pour composant infrarouge additionnel utilisé avec la carte
mère de son ordinateur)
# /etc/lirc/hardware.conf
#
# Arguments which will be used when launching lircd
LIRCD_ARGS=""
#Don't start lircmd even if there seems to be a good config file
#START_LIRCMD=true
#Try to load appropriate kernel modules
LOAD_MODULES=false
# Run "lircd --driver=help" for a list of supported drivers.
DRIVER="default"
# If DEVICE is set to /dev/lirc and devfs is in use /dev/lirc/0 will be
# automatically used instead
DEVICE="/dev/lirc0"
MODULES="lirc_dev lirc_sir"
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.
ANNEXE D : Messages d'erreurs
Le message d'erreur : « Pas de fichier de config 'hp.lirc'. » signifie que le
fichier hp.lirc ne se trouve pas dans le répertoire $HOME/.homeplayer (*nix) ou
C:\Documents and Settings\nom_utilisateur\.homeplayer (Windows™).
Le message d'erreur : « org.lirc.LIRCException: End of file » ou
« org.lirc.LIRCException: Error loading receiver (org.lirc.LinuxReceiver):
org.lirc.LIRCException: Connection refused
Error to init LIRC. » signifient que le serveur LIRC (démon lircd) n'est pas
démarrer et qu'il faut le démarrer2 avant de lancer HomePlayer.
2 sous Debian/Ubuntu /etc/init.d/lirc start (ou éventuellement restart)
©Ce document est soumis à la licence Creative Commons 2.0 BY-NC-SA et appartient aux
développeurs et aux contributeurs du mod HomePlayer.