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,
dabei entspricht:

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

Bildliche Anzeige von Tastencode / keycode findest du hier klicken

Zurück zur Übersicht:Gemini-Wiki:Portal oder Hauptseite