Keymap.xml
Die keymap.xml ist die Datei, in welcher z.B. für Plugins festgelegt wird, welcher Actions-Name beim Druck auf eine bestimmte Taste ausgelöst wird.
Beim Öffnen der keymap.xml sind Blöcke zu erkennen, welche sich immer in ähnlicher Form wiederholen:
<map context="MediaPlayerActions">
<device name="dreambox remote control (native)">
<key id="KEY_YELLOW" mapto="pause" flags="m" />
<key id="KEY_GREEN" mapto="play" flags="m" />
<key id="KEY_TV" mapto="stop" flags="b" />
<key id="KEY_TV" mapto="shift_stop" flags="l" />
<key id="KEY_RADIO" mapto="shift_record" flags="l" />
<key id="KEY_PREVIOUS" mapto="previous" flags="m" />
<key id="KEY_NEXT" mapto="next" flags="m" />
</device>
</map>
Die erste Zeile bestimmt einen eigenen Namen, der sich nicht wiederholen darf.
<map context="meinPluginActions">
In der zweiten Zeile wird das Gerät bestimmt, von welchem die Tasten-Aktion erwartet wird, das kann die Fernbedienung, erweiterte Fernbedienung, Tastatur sein. Hier mal die drei genannten:
<device name="dreambox remote control (native)"> <device name="dreambox advanced remote control (native)"> <device name="dreambox ir keyboard">
Danach werden die einzelnen Tasten definiert. Im obigen Beispiel also:
<key id="KEY_YELLOW" mapto="pause" flags="m" />
- key id="KEY_YELLOW": entspricht der gelben Taste auf der Fernbedienung. Die Tastencodes sind in Enigma festgelegt.
- mapto="pause": bestimmt, dass die gelbe Taste die Funktion pause auslösen soll.
- flags="m": bestimmt, welche Art von Tastenbetätigung der Auslöser ist:
- m = make -> Taste normal gedrückt
- l = long -> Taste lange gedrückt
- b = break -> Taste losgelassen
- r = repeat -> Taste festgehalten
- m kommt einmal, sobald die Taste gedrückt wurde
- r kommt dann nach "m", wenn man die Taste festhält; und das solange, bis man die Taste loslässt
- l kommt nachdem 5 repeats kamen, aber nur exakt einmal (repeat kommt dann trotzdem weiter)
- b kommt nachdem man die Taste losgelassen hat.
Auch in Kombination möglich, z. B. flags="mr"
Wenn man z. B. ein Fenster mit "m" öffnet, kann man im selben Kontext r/l/b für diese Taste nicht mehr benutzen. Deshalb muss man dann halt das Fenster erst auf "b" öffnen.
Unser eigenes Beispiel sieht nun also so aus:
<map context="meinPluginActions">
<device name="dreambox remote control (native)">
<key id="KEY_YELLOW" mapto="action1" flags="m" />
<key id="KEY_YELLOW" mapto="action2" flags="l" />
</device>
</map>
Um die Funktionen der Standard-Tastenbelegung und die hier festgelegte Tastenbelegung zu aktivieren, muss dann im Programm ein Import erfolgen, welcher etwa so aussieht:
from Components.ActionMap import NumberActionMap, ActionMap
Desweiteren werden dann die Tasten im Programm den einzelnen Funktionen zugeordnet:
self["actions"] = ActionMap(["meinPluginActions"],
{
"action1": self.erstes,
"action2": self.zweites,
}, -1)
Selbstverständlich muss auch der dazu passende Code-Abschnitt angelegt werden, damit etwas ausgeführt wird:
def erstes(self):
mache dies und das
def zweites(self):
mache dies und das
Jetzt ist also folgendes gemacht worden: Ein normales Drücken auf die gelbe Taste startet den Programmabschnitt Erstes, wird die gelbe Taste lange gedrückt, startet Zweites
