# Inställning av &kde;:s infraröda fjärrkontroll

Frank
Scheffold

    fscheffold@googlemail.com

Michael
Zanetti

    michael_zanetti@gmx.net

Gav
Wood

    gav@kde.org

Stefan
Asserhäll

    stefan.asserhall@comhem.se

Översättare
2010-01-06
2.0
2004
Gav Wood
2010
Frank Scheffold
Michael Zanetti

&kdelirc;-inställning: Infrastrukturen för &kde;:s infraröda fjärrkontrollfunktion.

KDE
irkick
kdelirc
kcmlirc
lirc

## Inledning

### Krav

För att &kde;:s ramverk för LIRC ska kunna användas, måste du ha ställt in LIRC på datorn. Om det är riktigt inställt, lyser &kdelirc;-ikonen i systembrickan röd . Om inte är den grå och överkryssad .

För mer information om LIRC, och hur man ställer in det, besök deras hemsida på http://www.lirc.org.

Observera: Vid inställning av LIRC rekommenderas att utnyttja namnrymder för knappar.

## Användning

Det finns tre flikar som ger dig flera delar med inställningar och ytterligare information. Den första fliken, som heter Fjärrkontrollfunktioner används för att ställa in lägen och åtgärder för alla tillgängliga fjärrkontroller. Fliken som heter Översikt av profiler innehåller detaljinformation om tillgängliga profiler. Fliken Tillgängliga fjärrkontroller visar ytterligare information om fjärrkontrollerna. Att välja en fjärrkontroll ger en översikt av dess knappar.

### Fjärrkontrollfunktioner

#### Fjärrkontroller och lägen

Varje fjärrkontroll kan ha ett antal olika lägen. Genom att ha flera lägen, kan samma knapp utföra olika åtgärder vid olika tillfällen. Tänk på det som en fjärrkontroll med flera användningar för tv, video, satellit och dvd. Istället för att använda olika fjärrkontroller för olika program, kan du ändra beteende hos en fjärrkontroll för att anpassa den till ett program genom att skapa olika lägen och byta mellan dem efter behov.

Åtgärder som definieras direkt för fjärrkontrollen är alltid tillgängliga, oberoende av vilket läge fjärrkontrollen för närvarande har. Åtgärder definierade i ett läge utförs bara om fjärrkontrollen för närvarande är inställd i det läget. Varje fjärrkontroll kan bara vara i ett läge åt gången. Den kan också inte vara i något läge alls, vilket betyder att bara åtgärder som alltid är tillgängliga utförs när knappar trycks ner. Man kan också definiera ett standardläge, vilket är det läge som automatiskt tilldelas vid start.

Listan till vänster innehåller alla fjärrkontroller som detekterats på datorn. Lägen kan läggas till och tas bort genom att markera önskad fjärrkontroll eller läge och använda knapparna direkt under listan. Knappen Redigera låter dig ändra befintliga lägen.

#### Tilldela åtgärder till knappar

&kdelirc; känner till två olika typer av åtgärder. Byte av läge och åtgärder att utföra. Byte av läge tillåter att nuvarande fjärrkontroll ställs om till ett annat läge, medan reguljära uttryck tillåter att kommandon utförs via &DBus;. När en ny åtgärd att utföra definieras har man två möjligheter. Det ena är att använda en mall, medan det andra kräver att alla möjliga alternativ måste anges manuellt. Mallar för åtgärder kallas profiler. Medan det är enklare och mer rättframt att använda profiler för att skapa åtgärder, är det inte möjligt att komma åt alla funktioner med profiler. Mer avancerade åtgärder kan ställas in genom att manuellt välja funktioner och deras parametrar.

Använd knappen Lägg till... nere till höger för att lägga till en åtgärd. En guide dyker upp och frågar dig vilken typ av åtgärd som ska skapas. Det första alternativet skapar en åtgärd baserad på en profil. Det andra alternativet låter dig skapa hela åtgärden manuellt. Kom ihåg att programmet du vill styra måste köra vid tillfället då åtgärden ställs in, annars visas det inte i listan med tillgängliga program. Det tredje alternativet låter dig skapa en åtgärd för att byta läge. Välj önskad typ av åtgärd, och följ stegen genom guiden.

Åtgärder kan också fyllas i automatiskt med knappen Fyll i automatiskt.... Det betyder att &kdelirc; kan försöka para ihop knappar med funktioner åt dig. Dialogrutan för att fylla i automatiskt visar alla tillgängliga profiler med en flagga. Beroende på flaggans färg stöds fjärrkontrollen fullständigt, delvis eller inte alls av profilen. Grön betyder fullständigt stöd, gul delvis stöd och röd inget stöd alls.

Observera: Om fjärrkontrollen inte är kompatibel med någon profil, kanske du inte har ställt in LIRC med namnrymder.

### Översikt av profiler

Fliken Översikt av profiler ger dig information om de tillgängliga profilerna. Genom att välja en profil kan du se detaljerad information som information om upphovsmannen och en lista med alla definierade åtgärder. Varje åtgärdspost innehåller information om ytterligare inställningar, en kommentar och identifieraren för knappen som ska användas av funktionen för att fylla i automatiskt.

Om du skulle vilja bidra med profiler för program, se kapitlet Avancerad information.

### Tillgängliga fjärrkontroller

Den här fliken ger dig detaljerad information om fjärrkontrollerna. Här kan du kontrollera om fjärrkontrollerna kändes igen riktigt av systemet.

## Avancerad information

Det här kapitlet beskriver viss information som kan vara intressant för mer avancerade användare eller utvecklare. Du får lära dig hur du kan skapa egna profiler.

### Skapa profiler

#### Inledning

Alla program som hanterar &DBus; kan användas med &kdelirc; utan några ytterligare åtgärder. För att tillhandahålla en användarvänlig inställning och låta programmet visas i dialogrutan för att fylla i automatiskt, kan du dock vilja skapa en profil för det.

En profil talar om för &kdelirc; (och användaren), vad de olika &DBus; anropen gör. Det är väsentligen en sorts dokumentation av &DBus; anropen. Du behöver inte inkludera alla &DBus; anrop, bara de du känner att slutanvändare kan dra störst nytta av (oftast anrop som modifierar gränssnittet istället för informationsinsamlande anrop).

#### Skapa

1. ##### &DBus;

   Försäkra dig om att programmet du vill skapa profilen för tillhandahåller funktioner via &DBus;. I stort sett kan du kontrollera det genom att försöka lägga till åtgärder för programmet med den manuella metoden i &kdelirc;. Programmet qdbusviewer som levereras med installationen av QT4 är också ett mycket bra verktyg för att ta reda på möjligheter med &DBus; i program.

2. ##### Skapa en profil

   När du väl har hittat lämpliga &DBus; funktioner, måste du beskriva dem i dokumentet `pgmnamn.profile.xml`. Här är en snabbguide om hur man skapar sådana filer:

   1. Skapa först en ny fil som har följande innehåll. Ersätt mittpgm med det körbara namnet på programmet och Mitt program med ett beskrivande programnamn.

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

            <profile id="mittpgm" servicename="Mitt program">
            </profile>

   2. Lägg till namn och information om upphovsmannen inne i taggen profile. Taggen instances talar om för &kdelirc; om programmet kan köras flera gånger eller inte. Ställ in unique till 0 om man kan starta programmet flera gånger (det är normalt 1). Egenskapen ifmulti anger vad &kdelirc; ska göra om flera instanser kör när en knapp trycks ner. Alternativen är skicka inte (gör ingenting för antal instanser > 1), sendtoone (skicka anropet till en godtyckligt vald instans) och sendtoall (skicka till alla instanser). Normalvärdet är dontsend, dock kan sendtoone vara det mest användbara under många omständigheter..

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

            <profile id="mittpgm" servicename="Mitt program">
              <name>Mitt program</name>
              <author>Mig</author>
              <instances unique="0" ifmulti="sendtoone"/>
            </profile>

   3. Fyll i profilen med åtgärdstaggar. Varje åtgärdstagg måste innehålla &DBus; objektnamn och funktionsprototypen.

      &kdelirc; behöver några ytterligare egenskaper för att veta hur en åtgärd ska hanteras. Taggen button används för funktionen för att fylla i automatiskt. Se dokumentationen av programmeringsgränssnittet för Solid för en fullständig lista av tillgängliga namn på knappar. Taggen repeat talar om ifall åtgärden ska utföras flera gånger om knappen på fjärrkontrollen hålles nere (0 = Nej, 1 = Ja). Taggen autostart definierar om programmet ska startas om det inte redan kör.

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

            <profile id="mittpgm" servicename="Mitt program">
              <name>Mitt program</name>
              <author>Mig</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MyApp" prototype="void showint(short int)"
                button="Menu" repeat="0" autostart="0">
              </action>
            </profile>

   4. Lägg till ett namn och en kommentar i åtgärden. Detta visas i &kdelirc;s användargränssnitt.

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

            <profile id="mittpgm" servicename="Mitt program">
              <name>Mitt program</name>
              <author>Mig</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MyApp" prototype="void showints(short int)"
                  button="Menu" repeat="0" autostart="0">
                <name>Visa heltal</name>
                <comment>Visar ett inställningsbart heltal</comment>
              </action>
            </profile>

   5. Beskriv varje argument med en kommentar och typegenskap. En lista med giltiga typer finns i filen med profilbeskrivning. Du måste deklarera ett standardvärde för varje argument mellan taggarna default:

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

            <profile id="mittpgm" servicename="Mitt program">
              <name>Mitt program</name>
              <author>Mig</author>
              <instances unique="0" ifmulti="sendtoone"/>
              <action objid="MyApp" prototype="void showints(short int)"
                  button="Menu" repeat="0" autostart="0">
                <name>Visa heltal</name>
                <comment>Visar ett inställningsbart heltal</comment>
                <argument type="int">
                  <default>5</default>
                  <comment>Heltalet som ska visas</comment>
                </argument>
              </action>
            </profile>

#### Installation

För att prova och använda profilen måste du kopiera den till `$(kde_datadir)/profiles` och starta om &kdelirc;.

Om du skulle vilja bidra profilen till &kde;:s programvarusamling, skicka den gärna till &kde;:s verktygsgrupp på kde-utils-devel@kde.org.