# Einstellungen für Infrarotfernbedienungen unter &kde;

Frank
Scheffold

    fscheffold@googlemail.com

Michael
Zanetti

    michael_zanetti@gmx.net

Gav
Wood

    gav@kde.org

Gregor
Zumstein

    gz@orchester-bremgarten.ch

Deutsche Übersetzung
2010-01-06
2.0
2004
Gav Wood
2010
Frank Scheffold
Michael Zanetti

&kdelirc; Einstellungen: Die Infrastruktur für die &kde;-Infrarot-Fernbedienungsfunktionalität.

KDE
irkick
kdelirc
kcmlirc
lirc

## Einführung

### Voraussetzungen

Um &kdelirc; benutzen zu können, muss LIRC auf Ihrem Rechner istalliert sein. Ist LIRC eingerichtet, wird das Symbol &kdelirc; im Systemabschnitt der Kontrollleiste rot markiert . IFalls LIRC nicht läuft, wird das Symbol grau mit einem roten Kreuz angezeigt .

Weitere Informationen zu LIRC und der Einrichtung finden Sie auf den Webseiten des Projekts www.lirc.org.

Hinweis: Bei der Einrichtung von LIRC ist es erforderlich, Namensräume für die Knöpfe zu benutzen.

## Benutzung

Es gibt drei Karteikarten mit mehreren Bereichen für die Einrichtung und zusätzlichen Informationen. Auf der ersten Karteikarte Steuerungsfunktionen können Modi und Aktionen für alle verfügbaren Fernbedienungen eingerichtet werden. Die Karteikarte Profilübersicht zeigt Details der verfügbaren Profile an. Auf der Karte Verfügbare Fernbedienungen sehen Sie zusätzliche Informationen zu den Fernbedienungen. Wählen Sie hier eine der Fernbedienungen aus, wird eine Übersicht der Bedienungsknöpfe angezeigt.

### Steuerungsfunktionen

#### Fernbedienungen und Modi

Jede Fernbedienung hat eine Anzahl unterschiedlicher Modi. Unterschiedliche Modi erlauben es, einer Taste je nach Anwendungsbereich unterschiedliche Funktionen zuzuweisen. Auf diese Weise können Fernbedienungen viele verschiedene Geräte mit nur einigen wenigen Knöpfen steuern. Ein Beispiel hierfür sind die Vielzweck-Fernbedienungen für TV/Video/DVD und weiteres. Diese haben wenige Tasten, welche je nach zu bedienendem Gerät unterschiedliche Funktionen besitzen.

Direkt für die Fernbedienung definierte Aktionen sind immer verfügbar, unabhängig vom aktuellen Modus der Fernbedienung. Aktionen, die für einen Modus definiert wurden, werden auch nur dann ausgeführt, wenn sich die Fernbedienung in diesem Modus befindet. Für eine Fernbedienung kann gleichzeitig nur ein Modus oder auch kein Modus aktiviert sein. Ist kein Modus aktiviert, werden nur die direkt definierten und immer verfügbaren Aktionen beim Drücken eines Knopfes ausgeführt. Außerdem kann ein Standardmodus angegeben werden, der der Fernbedienung automatisch beim Start zugewiesen wird.

Die Liste auf der linken Seite enthält alle angeschlossenen und entdeckten Fernbedienungen. Modi können hinzugefügt und wieder gelöscht werden, indem die gewünschte Fernbedienung ausgewählt und anschließend einer der Knöpfe unterhalb der Liste gedrückt wird. Mit dem Knopf „Bearbeiten“ können vorhandene Modi geäandert werden.

#### Zuweisung von Aktionen an Knöpfe

&kdelirc; unterscheidet zwei verschiedene Arten von Aktionen, Moduswechsel und ausführbare Aktionen. Mit Moduswechseln kann die aktuell aktivierte Fernbedienung in einen anderen Modus versetzt werden, mit ausführbaren Aktionen werden Befehle über die &DBus;-Schnittstelle ausgeführt. Wenn eine neue ausführbare Aktionen definiert wird, gibt es zwei Optionen. Es kann entweder eine Vorlage benutzt oder es müssen manuell alle möglichen Optionen eingestellt werden. Vorlagen für Aktionen werden Profile genannt. Die Benutzung von Profilen ist einfach und schnell, erlaubt aber nicht den Zugriff auf alle verfügbaren Aktionen. Erweiterte Aktionen können nur eingerichtet werden, indem die Funktionen und deren Parameter manuell eingetragen werden.

Benutzen Sie den Knopf Hinzufügen ... rechts unten, um eine neue Aktion zu definieren. Damit wird ein Assistent gestartet, in dem zuerst der Typ der neuen Aktion ausgewählt werden muss. Die erste Option erstellt eine Aktion auf der Grundlage eines Profils, mit der zweiten Option kann die gesamte Aktion manuell definiert werden. Beachten Sie, dass das Programm ausgeführt werden muss, wenn Sie dafür eine neue Aktion festlegen möchten oder es wird nicht in der Liste der verfügbaren Programme angezeigt. Mit der dritten Option kann eine Aktion für einen Moduswechsel erstellt werden. Wählen Sie die gewünschte Art der Aktion und folgen Sie den weiteren Anweisungen im Assistenten.

Aktionen können auch automatisch durch Drücken des Knopfes Automatisch ausfüllen ... erzeugt werden. Es öffnet sich ein Dialog, in dem alle verfügbaren Profile mit einer Markierung angezeigt werden. An der Farbe dieser Markierung erkennen Sie, ob Ihre Fernsteuerung vollständig (Grün). teilweise (Gelb) oder gar nicht (Rot) unterstützt wird.

Hinweis: Wenn Ihre Fernbedienung mit keinem Profil kompatibel ist, haben Sie lirc vermutlich nicht für die Verwendung von Namensräumen eingerichtet.

### Profilübersicht

Die Karteikarte Profilübersicht zeigt alle vorhandenen Profile an. Wählen Sie ein Profil, um ausführliche Informationen wie den Namen des Autors und alle definierten Aktionen zu sehen. Jeder Eintrag einer Aktion enthält Informationen über zusätzliche Einstellungen, einen Kommentar und die Kennung, die beim automatischen Ausfüllen benutzt wird.

Möchten Sie Anwendungsprofile zu diesem Programm beisteuern, lesen Sie bitte das Kapitel zusätzliche Informationen.

### Verfügbare Fernbedienungen

Diese Karteikarte gibt Ihnen ausführliche Informationen zu Ihren Fernbedienungen. Hier können Sie überprüfen, ob Ihre Fernbedienungen vom System erkannt wurden.

## Zusätzliche Informationen

In diesem Kapitel werden zusätzliche Information vorgestellt, die für einen erfahrenen Benutzer oder Entwickler von Interesse sind. In diesem Kapitel finden Sie eine Anweisung, um benutzerdefinierte Profile zu erstellen.

### Erstellung eines Profils

#### Einführung

Alle Programme mit einer &DBus;-Schnittstelle können durch &kdelirc; ohne zusätzliche Aktionen benutzt werden. Um aber eine grafische Benutzerschnittstelle für die Einrichtung bereitzustellen und das Programm im Dialog Automatisch ausfüllen anzuzeigen, sollten Sie ein Profil dafür erstellen.

Ein Profil gibt &kdelirc; und dem Benutzer die Funktion der verschiedenen &DBus;-Aufrufe an, Im Grunde ist das eine Art von Dokumentation der &DBus;-Aufrufe. Es müssen nicht alle &DBus;-Aufrufe aufgeführt sein, nur die Wichtigsten für den Endbenutzer. Dazu gehören eher die Aufrufe um die Schnittstelle einzurichten als die Aufrufe zu Abfrage von Informationen.

#### Erstellung

1. ##### &DBus;

   Überprüfen Sie, ob das Programm für das Sie ein Profile erstellen möchten, eine &DBus;-Schnittstelle hat. Dazu versuchen Sie, in &kdelirc; manuell eine Aktion für dieses Programm hinzuzufügen. Auch mit dem Programm qdbusviewer, das zusammen mit Qt4 installiert wird, können Sie Informationen über die &DBus;-Schnittstelle eines Programms finden.

2. ##### Ein Profil erstellen

   Wenn Sie die passenden &DBus;-Funktionen gefunden haben, müssen diese in der Datei `appname.profile.xml` beschrieben werden. Im folgenden Abschnitt finden Sie eine kurze Einführung zur Erstellung dieser Dateien:

   1. Erstellen Sie zuerst eine neue Datei mit dem folgenden Inhalt. Ersetzen Sie myapp mit dem Namen des ausführbaren Programms und My Application mit einer beschreibendem Name für die Anwendung.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="myapp" servicename="My Application">
            </profile>

   2. In der profile-Markierung geben Sie den Namen und Informationen über den Autor an. Mit der Einstellung instances legen Sie fest, ob ein Programm mehrfach ausgeführt werden kann. Setzen Sie dafür den Wert für unique auf 0, die Voreinstellung ist 1 (das Programm kann nur einmal ausgeführt werden). Die Eigenschaft ifmulti bestimmt, wie &kdelirc; mehrere Instanzen des Programms behandelt, wenn ein Knopf gedrückt wird. Es erfolgt entweder keine Aktion für mehr als eine laufende Instanz eines Programms (dontsend), der Aufruf wird an eine willkürlich ausgewählte Instanz (sendtoone) oder an alle laufenden Programme (sendtoall) geschickt. Die Voreinstellung ist dontsend, in vielen Fällen kann die Einstellung sendtoone sinnvoller sein.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="myapp" servicename="My Application">
              <name>My Application</name>
              <author>Me</author>
              <instances unique="0" ifmulti="sendtoone"/>
            </profile>

   3. Geben Sie für das Profil action-Markierungen an. Jede Markierung soll den Namen des &DBus;-Objekts und einen Funktionsprototyp enthalten.

      &kdelirc; benötigt zusätzliche Attribute, um eine Aktion richtig zu verarbeiten. Die button-Markierung wird für die das automatische Ausfüllen benötigt. In der API-Dokumentation für Solid finden Sie eine Liste aller verfügbaren Namen für Knöpfe. Die repeat-Markierung gibt an, ob die Aktion mehrfach ausgeführt werden soll, wenn der Knopf auf der Fernbedienung länger gedrückt wird (0 = Nein, 1 = Ja). Die autostart-Markierung definiert, ob das Programm automatisch gestartet werden soll, wenn es noch nicht läuft.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="myapp" servicename="My Application">
              <name>My Application</name>
              <author>Me</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MyApp" prototype="void showint(short int)"
                button="Menu" repeat="0" autostart="0">
              </action>
            </profile>

   4. Fügen Sie für die Aktion einen Namen und einen Kommentar hinzu. Dies wird in der Benutzerschnittstelle von &kdelirc; angezeigt.

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="myapp" servicename="My Application">
              <name>My Application</name>
              <author>Me</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MyApp" prototype="void showints(short int)"
                  button="Menu" repeat="0" autostart="0">
                <name>Show Integers</name>
                <comment>Shows a configurable integer</comment>
              </action>
            </profile>

   5. Beschreiben Sie jedes Argument mit einem Kommentar und geben den Typ des Attributs an. Eine Liste gültiger Typen finden Sie in der Profilbeschreibungsdate. Für jedes Argument sollte ein Standardwert der default-Markierung gesetzt werden:

          <?xml version="1.0" ?>
          <!DOCTYPE profile SYSTEM "profile.dtd">

            <profile id="myapp" servicename="My Application">
              <name>My Application</name>
              <author>Me</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MyApp" prototype="void showints(short int)"
                  button="Menu" repeat="0" autostart="0">
                <name>Show Integers</name>
                <comment>Shows a configurable integer</comment>
                <argument type="int">
                  <default>5</default>
                  <comment>The integer to be shown</comment>
                </argument>
              </action>
            </profile>

#### Installation

Um das Profil zu benutzen und zu testen, müssen Sie es in den Ordner `$(kde_datadir)/profiles` kopieren und &kdelirc; neu starten.

Möchten Sie Profile zur &kde; SC beisteuern, senden sie sie bitte unter der Adresse kde-utils-devel@kde.org an das KDE-Utils-Team .